Images

Use GET /api/open/v1/media/models?mediaType=image to discover verified models, POST /api/open/v1/media/images/jobs to generate, and GET /api/open/v1/media/images/jobs/{jobId} to read a job owned by the API-key user.

Request

Create requests use bearer authentication and API quota:

Authorization: Bearer KITTA_API_KEY
Idempotency-Key: UNIQUE_REQUEST_ID

curl https://kittaai.com/api/open/v1/media/images/jobs \
  -H "Authorization: Bearer $KITTA_API_KEY" \
  -H "Idempotency-Key: image-$(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"prompt":"cinematic product photo","model":"nano-banana","aspect_ratio":"9:16"}'

Response

Image task responses typically include task id, status, result image URL on success, and an error code on failure. Store the task id before polling so users can recover the result after page refresh or worker restart.

Billing And Credits

The endpoint uses API quota, not website member credits. Provider, storage, or persistence failures are refunded idempotently. Check Profile before large batches.

Idempotency-Key is required and must be unique for each intended creation. Retrying the same request with the same key returns the original response without creating or charging a second task.

Errors

Handle unsupported model, invalid reference image, insufficient credits, and processing failure separately. If image endpoints are absent from GET /api/openapi.json, treat the capability as not publicly available for the account.