Skip to content

Async image tasks

These routes accept the same non-streaming image payload as the synchronous endpoint. A successful submission returns 202 Accepted, poll_url, and Retry-After; poll that URL with the same key until completed or failed. If server-side image task storage is unavailable, the feature returns 404 without accepting work.

Configure

bash
curl 'https://ai.tavonilo.com/v1/images/generations/async' \
  -H "Authorization: Bearer $AI_SHOP_API_KEY" \
  -H 'Content-Type: application/json' \
  -d '{"model":"<IMAGE_MODEL_ID>","prompt":"A minimal product illustration"}'

# The 202 response contains poll_url. Query that URL with the same key.

These routes accept the same non-streaming image payload as the synchronous endpoint. A successful submission returns 202 Accepted, poll_url, and Retry-After; poll that URL with the same key until completed or failed. If server-side image task storage is unavailable, the feature returns 404 without accepting work.

Verify and recover

Check the key with /v1/models, make one small non-sensitive request, and retain only the timestamp, route, model, HTTP status, and request ID for support. A timeout does not prove a billable generation was not processed, so do not blindly replay long or image requests.

Security boundary

Use one key per device or workload. Never send an API key, auth.json, full private prompt, password, verification code, or payment data to support; revoke and replace a key immediately when exposure is suspected.

API access is subject to the AIShop service terms.