Legacy Guide (Sync)
The synchronous endpoint POST /v1/images/generations no longer supports the Vega series: calls return 400 model ... tiered expr run failed. Use the new async task API instead (submit → poll → download; the token-free content_url is time-limited — transfer promptly). This page keeps the pre-upgrade synchronous integration for transition reference only.
This page covers the two ways the Vega series was used through the synchronous endpoint before the migration: text-to-image (Vega-specific fields and recommended resolutions) and image-to-image (reference images via input). Available models and current prices are subject to the Model Plaza.
Text-to-Image (Vega Series)
All three models share the synchronous endpoint /v1/images/generations and its common request fields (see Text-to-Image & Image-to-Image). Vega-specific conventions:
Common supported resolutions (widthxheight, mapped to aspect ratios):
Response example:
Vega is billed per call (a text-to-image call consumes roughly 13,500 tokens), and usage.total_tokens is handy for billing reconciliation; data[].url is a signed download link valid for 7 days — download and re-host it promptly.
Image-to-Image (Vega Series)
Same synchronous endpoint: reference images are passed through Vega's native input field via extra_body, and multiple reference images are supported (passing only prompt without input is plain text-to-image):
Reference image limits per model:
Notes for the Vega series:
- The
promptmust include wording like "keep the original image / design", otherwise the model ignores the reference images and treats the task as plain text-to-image nis fixed at 1; one image per call- Reference image resolution does not affect output size (determined by
size); max 10MB per image, PNG / JPEG supported - Billed per call; image-to-image consumes extra tokens depending on the number of reference images:
proincludes the first 3 reference images free, and each image from the 4th on consumes roughly 10,000 extra tokens
