Media API: images and videos

GET /images/models and GET /videos/models list every media model with its sizes or resolutions, modes (generate, edit, text or image to video), input limits, durations and price per image or per second. They are the authoritative list; prices also appear in the public price list.

• Some models offer one fixed size and quality (listed as low:1024x1024); a request for another size or quality is refused with 400 instead of being changed silently.
• The image you get back has exactly the size you asked for: a provider image of another size is scaled and centre-cropped to it.

• Fields: model, prompt (up to 4,000 bytes), size (one the model lists; omitted or auto means its first), n (1 to 4), response_format (b64_json only). quality, background and output_format are accepted for SDK compatibility but do not change the result, except on the fixed-quality models, which refuse any quality but low.
• n above 1 runs one provider request per image in parallel; you are charged only for the images returned. When none succeeds, nothing is charged and the provider error is returned.
• Edits: multipart image fields (as many as the model's max_input_images); masks are not supported.
• Responses are synchronous and can take up to a few minutes; set your client timeout accordingly.

curl "https://api.vani.ai/v1/images/generations" \
  -H "Authorization: Bearer $VANI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"openai/gpt-image-2.5","prompt":"a red cube on a white table","size":"1024x1024","n":2}'

• POST /videos (JSON or multipart with first_frame, last_frame, input_reference or reference files) answers 202 with a video object (id, status, model, seconds, resolution, ratio).
• Poll GET /videos/{id}; when status is completed, download GET /videos/{id}/content (MP4, byte ranges supported). Files are kept for 7 days.
• GET /videos?limit=&after=&order= lists your jobs, newest first (data, first_id, last_id, has_more).
• Send an Idempotency-Key: repeating the same request with the same key returns the job it created (200, x-vani-idempotent-replay: true) instead of starting a second, paid one.
• A failed job releases its reservation; you are charged only for delivered videos.

curl "https://api.vani.ai/v1/videos" \
  -H "Authorization: Bearer $VANI_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"model":"x-ai/grok-imagine-video-1.5","prompt":"waves at sunset","seconds":6,"resolution":"720p"}'

curl "https://api.vani.ai/v1/videos/$VIDEO_ID" -H "Authorization: Bearer $VANI_API_KEY"

• Plan-billed keys (created in Vani Chat) get 403 api_wallet_key_required; media in Vani Chat uses the plan's allowance instead.
• Video requests count toward your tier's concurrent-request limit while they run.
• Errors use Vani's envelope: {"error": {"code", "message", "details"}}.