> ## Documentation Index > Fetch the complete documentation index at: https://docs.vidgo.ai/llms.txt > Use this file to discover all available pages before exploring further. # Ideogram Vector 1.0 Image to SVG > The Ideogram Vector 1.0 Image to SVG API converts one PNG, JPG or WebP image into an editable SVG file, in default (detailed) or simple mode. > [!TIP] > > 1. After submission, a `task_id` will be returned. If you provided a `callback_url`, when the task status becomes `finished` or `failed`, a POST request will be sent to the `callback_url`. > 2. Regardless of whether `callback_url` is provided, you can retrieve the result through the unified [Query Task Status](https://docs.vidgo.ai/api-manual/task-management/status.md) endpoint. Ideogram Vector 1.0 Image to SVG converts a raster image, such as a PNG logo, a scanned sketch or a JPG illustration, into an SVG file you can scale and edit in a vector tool. Choose `default` mode for detail or `simple` mode for a cleaner, flatter result. No prompt is needed. Ideogram Vector 1.0 is Ideogram's first model that outputs vector graphics instead of pixels. Vidgo exposes it as two model IDs: [Text to SVG](https://docs.vidgo.ai/api-manual/image-series/ideogram-vector-1-0-text-to-vector.md) and [Image to SVG](https://docs.vidgo.ai/api-manual/image-series/ideogram-vector-1-0-image-to-vector.md). ## Models * **ideogram/vector-1.0/image-to-vector** — Image to SVG with Ideogram Vector 1.0: one image in, one SVG out. ## Features * Image-to-SVG vectorization of one image per request. * Two styles: `default` (finer detail) and `simple` (fewer shapes). * Accepts a public URL or an image data URI. ## Required parameters * `image_urls` (string\[]): Exactly one image (PNG, JPG or WebP recommended). Public HTTP(S) URL or `data:image/...;base64,...` data URI. ## Optional parameters * `mode` (string): `default` or `simple`. Default `default`. ## Output The finished task returns SVG files (`image/svg+xml`) in the `files` array of [Query Task Status](https://docs.vidgo.ai/api-manual/task-management/status.md) and the callback payload. Open them in any vector editor or embed them directly in a web page. ## Examples * **Vectorize a logo in default mode**: one PNG logo, `mode: default`. * **Simple mode with callback**: a JPG sketch, `mode: simple`, with a `callback_url`. ## Notes * This ID takes no `prompt`; sending one returns 400. To create new SVG artwork from text, use [Ideogram Vector 1.0 Text to SVG](https://docs.vidgo.ai/api-manual/image-series/ideogram-vector-1-0-text-to-vector.md). * `image_urls` must contain exactly one image. Fields not listed above return 400. `model` and `callback_url` belong at the request root, not inside `input`. * Each request is billed at one flat rate per SVG; `mode` does not change the price. A failed task is refunded in full. See the [pricing page](https://vidgo.ai/apis/api-pricing) for current rates. ## OpenAPI ````yaml api-manual/image-series/ideogram-vector-1-0-image-to-vector.json POST /api/generate/submit openapi: 3.0.0 info: title: Vidgo API - Ideogram Vector 1.0 Image to SVG description: >- The Ideogram Vector 1.0 Image to SVG API converts one PNG, JPG or WebP image into an editable SVG file, in default (detailed) or simple mode. version: 1.0.0 servers: - url: https://api.vidgo.ai description: Production server security: - BearerAuth: [] paths: /api/generate/submit: post: tags: - Image Series summary: Ideogram Vector 1.0 Image to SVG description: >- Send only the `input` fields listed for this model. Any other field, including `prompt`, returns 400. `image_urls` accepts a public HTTP(S) URL or a `data:image/...;base64,...` data URI. operationId: submit_ideogram_vector_1_0_image_to_vector requestBody: required: true content: application/json: schema: type: object required: - model - input properties: model: type: string description: Model ID. Use `ideogram/vector-1.0/image-to-vector`. example: ideogram/vector-1.0/image-to-vector callback_url: type: string format: uri nullable: true description: >- Optional public HTTP(S) endpoint that receives a POST when the task becomes `finished` or `failed`. HTTPS is recommended. Omit it, or send `null` or an empty string, to disable callbacks. example: https://your-domain.com/callback input: type: object required: - image_urls properties: image_urls: type: array items: type: string format: uri minItems: 1 maxItems: 1 example: - https://example.com/logo.png description: >- Exactly one raster image to vectorize: a public HTTP(S) URL or an image data URI. mode: type: string enum: - default - simple default: default description: >- Vectorization style. `default` keeps finer detail; `simple` uses fewer, cleaner shapes. additionalProperties: false description: Generation parameters. examples: default_mode: summary: Vectorize a logo in default mode value: model: ideogram/vector-1.0/image-to-vector input: image_urls: - https://example.com/logo.png mode: default simple_mode: summary: Simple mode with callback value: model: ideogram/vector-1.0/image-to-vector callback_url: https://your-domain.com/callback input: image_urls: - https://example.com/sketch.jpg mode: simple responses: '200': description: Task submitted content: application/json: schema: type: object required: - code - data properties: code: type: integer enum: - 200 description: HTTP status code. data: type: object required: - task_id - status - created_time properties: task_id: type: string description: >- Task ID. Use it with [Query Task Status](/api-manual/task-management/status). status: type: string enum: - not_started description: Initial task status. created_time: type: string format: date-time description: Time the task was created (ISO 8601). example: code: 200 data: task_id: task-unified-1762160000-abc123 status: not_started created_time: '2026-11-03T10:30:00' '400': description: >- Invalid input, unsupported field, inaccessible media, or insufficient credits content: application/json: schema: type: object required: - detail properties: detail: oneOf: - type: string - type: object additionalProperties: true - type: array items: {} description: Error message. '401': description: Invalid credentials content: application/json: schema: type: object required: - detail properties: detail: oneOf: - type: string - type: object additionalProperties: true - type: array items: {} description: Error message. '403': description: Access denied content: application/json: schema: type: object required: - detail properties: detail: oneOf: - type: string - type: object additionalProperties: true - type: array items: {} description: Error message. '404': description: Unknown or disabled model content: application/json: schema: type: object required: - detail properties: detail: oneOf: - type: string - type: object additionalProperties: true - type: array items: {} description: Error message. '408': description: Request timed out content: text/plain: schema: type: string example: Request timeout '422': description: Invalid JSON or non-object request body content: application/json: schema: type: object required: - detail properties: detail: oneOf: - type: string - type: object additionalProperties: true - type: array items: {} description: Error message. '429': description: Rate or API key credit limit exceeded content: application/json: schema: type: object required: - detail properties: detail: oneOf: - type: string - type: object additionalProperties: true - type: array items: {} description: Error message. '500': description: Internal error content: application/json: schema: type: object required: - detail properties: detail: oneOf: - type: string - type: object additionalProperties: true - type: array items: {} description: Error message. '502': description: Unable to create the upstream generation task content: application/json: schema: type: object required: - detail properties: detail: oneOf: - type: string - type: object additionalProperties: true - type: array items: {} description: Error message. '503': description: The requested model is temporarily unavailable content: application/json: schema: type: object required: - detail properties: detail: oneOf: - type: string - type: object additionalProperties: true - type: array items: {} description: Error message. components: securitySchemes: BearerAuth: type: http scheme: bearer bearerFormat: API Key description: >- All API endpoints require Bearer Token authentication Get your API Key: Go to **Dashboard → API Key** ([API Key Management Page](https://vidgo.ai/apis/dashboard/api-key)) to get your API Key Add it to the request header: ``` Authorization: Bearer VIDGO_API_KEY ``` ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.