Image
Create and poll flat-priced image generation tasks, and image model pricing.
Image generation shares the authentication, uploads, callbacks and errors documented in the Overview.
Create an image task
POST /api/v3/images/generations/tasks — creates a flat-priced image task and reserves the price from your balance. Same content shape as video: exactly one text prompt plus up to nine optional image_url reference images (a text-only prompt is allowed). On success the task carries content.image_url.
curl -s -X POST "$TOKENSTORE_URL/api/v3/images/generations/tasks" \
-H "Authorization: Bearer sk-..." \
-H "Content-Type: application/json" \
-d '{
"model": "seahorse-image",
"content": [
{"type": "text", "text": "a clean studio product shot of the sneaker on marble"},
{"type": "image_url", "image_url": {"url": "https://example.com/ref.jpg"}}
],
"size": "2K",
"callback_url": "https://example.com/webhooks/nureta-developer"
}'
# => {"id": "cgt-..."}Fields
| Field | Required | Notes |
|---|---|---|
model | yes | seahorse-image (see Image models & pricing). |
content | yes | Non-empty array. Include exactly one text item (the prompt). |
content[].type | yes | text or image_url. |
image_url.url | for image_url | HTTPS/HTTP reference image URL — your own hosted URL, or the assetUrl returned by Upload a reference image. Up to 9 image items, all optional (a text-only prompt is allowed). |
size | no | Default 2K. Allowed: 2K, 4K. |
callback_url | no | HTTPS endpoint to POST the terminal task response to. See Callback webhook. |
callback_secret | no | 8–256 character shared secret used to sign the callback body. Requires callback_url. |
Reference images use the same Upload a reference image flow as video.
Retrieve an image task
GET /api/v3/images/generations/tasks/:id — poll until status is succeeded or failed. On success the response carries content.image_url; on failure it carries an error and a refund is issued automatically.
curl -s "$TOKENSTORE_URL/api/v3/images/generations/tasks/cgt-..." \
-H "Authorization: Bearer sk-..."Image models & pricing
GET /api/v3/images/models (public) returns the image model with its per-image price and allowed sizes. Images are flat-priced — one image, one charge, no duration.
| Model | Sizes | USD / image |
|---|---|---|
seahorse-image | 2K, 4K | $0.05 |