{ "components": { "schemas": { "AnthropicMessage": { "additionalProperties": true, "properties": { "content": { "anyOf": [ { "type": "string" }, { "items": {}, "type": "array" } ] }, "role": { "enum": [ "user", "assistant" ], "type": "string" } }, "required": [ "role", "content" ], "type": "object" }, "Boolean": { "type": "boolean" }, "ChatRequest": { "additionalProperties": true, "properties": { "max_completion_tokens": { "description": "Newer name for max_tokens; model support determines the actual limit.", "type": "integer" }, "max_tokens": { "description": "If no limit is set, the documented 4096 bound is reduced by model limits; Grok has its own limit.", "type": "integer" }, "messages": { "items": { "$ref": "#/components/schemas/Message" }, "type": "array" }, "model": { "type": "string" }, "reasoning_effort": { "enum": [ "low", "medium", "high" ], "type": "string" }, "response_format": { "additionalProperties": true, "properties": { "type": { "enum": [ "json_object", "json_schema" ], "type": "string" } }, "type": "object" }, "stop": { "anyOf": [ { "type": "string" }, { "items": { "type": "string" }, "type": "array" } ] }, "stream": { "default": false, "type": "boolean" }, "stream_options": { "additionalProperties": true, "properties": { "include_usage": { "type": "boolean" } }, "type": "object" }, "temperature": { "description": "Usually 0 to 2; reasoning models may ignore it. This is not a universal range.", "type": "number" }, "tool_choice": { "anyOf": [ { "enum": [ "auto", "none", "required" ], "type": "string" }, { "type": "object" } ] }, "tools": { "items": { "additionalProperties": true, "properties": { "function": { "type": "object" }, "type": { "type": "string" } }, "type": "object" }, "type": "array" }, "top_p": { "type": "number" } }, "required": [ "model", "messages" ], "type": "object" }, "ChatResponse": { "additionalProperties": true, "properties": { "choices": { "items": { "additionalProperties": true, "properties": { "finish_reason": { "type": "string" }, "message": { "additionalProperties": true, "properties": { "content": {}, "role": { "type": "string" } }, "type": "object" } }, "type": "object" }, "type": "array" }, "created": { "type": "integer" }, "id": { "type": "string" }, "model": { "type": "string" }, "object": { "type": "string" }, "usage": { "$ref": "#/components/schemas/Usage" } }, "type": "object" }, "CountTokensRequest": { "additionalProperties": true, "properties": { "messages": { "items": { "$ref": "#/components/schemas/Message" }, "type": "array" }, "model": { "type": "string" } }, "required": [ "model", "messages" ], "type": "object" }, "EmbeddingsRequest": { "additionalProperties": true, "properties": { "encoding_format": { "default": "float", "description": "Format choice depends on model support.", "enum": [ "float", "base64" ], "type": "string" }, "input": { "anyOf": [ { "type": "string" }, { "items": { "type": "string" }, "type": "array" } ] }, "input_type": { "type": "string" }, "model": { "type": "string" } }, "required": [ "model", "input" ], "type": "object" }, "EmbeddingsResponse": { "additionalProperties": true, "properties": { "data": { "items": { "additionalProperties": true, "properties": { "embedding": { "items": { "type": "number" }, "type": "array" }, "index": { "type": "integer" } }, "type": "object" }, "type": "array" }, "usage": { "$ref": "#/components/schemas/Usage" } }, "type": "object" }, "Error": { "anyOf": [ { "additionalProperties": true, "properties": { "code": { "type": "string" }, "error": { "$ref": "#/components/schemas/PublicError" }, "message": { "type": "string" } }, "type": "object" }, { "additionalProperties": true, "properties": { "error": { "$ref": "#/components/schemas/PublicError" }, "request_id": { "type": "string" }, "type": { "const": "error" } }, "type": "object" }, { "additionalProperties": true, "properties": { "error": { "additionalProperties": true, "properties": { "code": { "type": "integer" }, "details": { "items": {}, "type": "array" }, "message": { "type": "string" }, "status": { "type": "string" } }, "type": "object" } }, "type": "object" } ] }, "GeminiPart": { "additionalProperties": true, "properties": { "fileData": { "additionalProperties": true, "properties": { "fileUri": { "description": "Public HTTPS URL; YouTube MIME type may be omitted.", "type": "string" }, "mimeType": { "type": "string" } }, "required": [ "fileUri" ], "type": "object" }, "functionCall": { "type": "object" }, "functionResponse": { "type": "object" }, "inlineData": { "additionalProperties": true, "properties": { "data": { "minLength": 1, "type": "string" }, "mimeType": { "type": "string" } }, "required": [ "mimeType", "data" ], "type": "object" }, "text": { "type": "string" }, "thoughtSignature": { "type": "string" }, "videoMetadata": { "additionalProperties": true, "properties": { "endOffset": { "type": "string" }, "fps": { "exclusiveMinimum": 0, "maximum": 24, "type": "number" }, "startOffset": { "type": "string" } }, "type": "object" } }, "type": "object" }, "GenerateContentRequest": { "additionalProperties": true, "properties": { "contents": { "items": { "additionalProperties": true, "properties": { "parts": { "items": { "$ref": "#/components/schemas/GeminiPart" }, "type": "array" }, "role": { "enum": [ "user", "model" ], "type": "string" } }, "required": [ "role", "parts" ], "type": "object" }, "type": "array" }, "generationConfig": { "additionalProperties": true, "description": "Text models use only TEXT; IMAGE/imageConfig only for documented Gemini image output. Model support determines numeric ranges. Use one supported JSON schema field.", "properties": { "candidateCount": { "const": 1 }, "frequencyPenalty": { "type": "number" }, "imageConfig": { "additionalProperties": true, "properties": { "aspectRatio": { "enum": [ "1:1", "2:3", "3:2", "3:4", "4:3", "4:5", "5:4", "9:16", "16:9", "21:9", "1:4", "4:1", "1:8", "8:1" ], "type": "string" }, "imageSize": { "enum": [ "1K", "2K", "4K" ], "type": "string" } }, "type": "object" }, "maxOutputTokens": { "type": "integer" }, "presencePenalty": { "type": "number" }, "responseJsonSchema": { "type": "object" }, "responseMimeType": { "enum": [ "text/plain", "application/json" ], "type": "string" }, "responseModalities": { "items": { "enum": [ "TEXT", "IMAGE" ], "type": "string" }, "minItems": 1, "type": "array", "uniqueItems": true }, "responseSchema": { "type": "object" }, "seed": { "type": "integer" }, "stopSequences": { "items": { "type": "string" }, "type": "array" }, "temperature": { "type": "number" }, "thinkingConfig": { "type": "object" }, "topK": { "type": "number" }, "topP": { "type": "number" } }, "type": "object" }, "safetySettings": { "items": { "additionalProperties": true, "properties": { "category": { "type": "string" }, "method": { "type": "string" }, "threshold": { "type": "string" } }, "required": [ "category", "threshold" ], "type": "object" }, "type": "array" }, "systemInstruction": { "type": "object" }, "toolConfig": { "additionalProperties": true, "properties": { "functionCallingConfig": { "additionalProperties": true, "properties": { "allowedFunctionNames": { "items": { "type": "string" }, "type": "array" }, "mode": { "enum": [ "AUTO", "ANY", "NONE", "VALIDATED", "MODE_UNSPECIFIED" ], "type": "string" } }, "type": "object" } }, "type": "object" }, "tools": { "items": { "additionalProperties": true, "properties": { "functionDeclarations": { "items": {}, "type": "array" }, "googleSearch": { "type": "object" }, "urlContext": { "type": "object" } }, "type": "object" }, "type": "array" } }, "required": [ "contents" ], "type": "object" }, "GenerateContentResponse": { "additionalProperties": true, "properties": { "candidates": { "items": {}, "type": "array" }, "modelVersion": { "type": "string" }, "usageMetadata": { "additionalProperties": true, "properties": { "candidatesTokenCount": { "type": "integer" }, "promptTokenCount": { "type": "integer" }, "toolUsePromptTokenCount": { "type": "integer" }, "totalTokenCount": { "type": "integer" } }, "type": "object" } }, "type": "object" }, "ImageEditRequest": { "additionalProperties": true, "properties": { "image": { "contentMediaType": "application/octet-stream", "description": "One or more unencoded binary multipart images." }, "mask": { "contentMediaType": "application/octet-stream", "description": "Optional binary multipart mask." }, "model": { "type": "string" }, "n": { "type": "integer" }, "prompt": { "type": "string" }, "response_format": { "type": "string" }, "size": { "type": "string" } }, "required": [ "model", "prompt", "image" ], "type": "object" }, "ImageRequest": { "additionalProperties": true, "properties": { "model": { "type": "string" }, "n": { "type": "integer" }, "prompt": { "type": "string" }, "quality": { "type": "string" }, "response_format": { "description": "Only where the exact model supports format selection.", "enum": [ "url", "b64_json" ], "type": "string" }, "size": { "type": "string" } }, "required": [ "model", "prompt" ], "type": "object" }, "ImageTask": { "additionalProperties": true, "properties": { "completed_at": { "format": "int64", "type": "integer" }, "created_at": { "format": "int64", "type": "integer" }, "error": {}, "expires_at": { "format": "int64", "type": "integer" }, "http_status": { "type": "integer" }, "id": { "type": "string" }, "image_url": { "type": "string" }, "object": { "type": "string" }, "poll_url": { "type": "string" }, "result": { "$ref": "#/components/schemas/ImagesResponse" }, "status": { "enum": [ "processing", "completed", "failed" ] }, "task_id": { "type": "string" } }, "type": "object" }, "ImagesResponse": { "additionalProperties": true, "properties": { "data": { "items": { "additionalProperties": true, "properties": { "b64_json": { "type": "string" }, "url": { "type": "string" } }, "type": "object" }, "type": "array" }, "task_id": { "type": "string" }, "usage": { "$ref": "#/components/schemas/Usage" } }, "type": "object" }, "Integer": { "type": "integer" }, "Message": { "additionalProperties": true, "properties": { "content": { "anyOf": [ { "type": "string" }, { "items": {}, "type": "array" } ] }, "role": { "enum": [ "system", "developer", "user", "assistant", "tool" ], "type": "string" } }, "required": [ "role", "content" ], "type": "object" }, "MessagesRequest": { "additionalProperties": true, "properties": { "max_tokens": { "type": "integer" }, "messages": { "items": { "$ref": "#/components/schemas/AnthropicMessage" }, "type": "array" }, "model": { "type": "string" }, "stop_sequences": { "items": { "type": "string" }, "type": "array" }, "stream": { "type": "boolean" }, "system": { "anyOf": [ { "type": "string" }, { "items": {}, "type": "array" } ] }, "temperature": { "maximum": 1, "minimum": 0, "type": "number" }, "thinking": { "additionalProperties": true, "properties": { "budget_tokens": { "type": "integer" }, "type": { "type": "string" } }, "type": "object" }, "tool_choice": { "additionalProperties": true, "properties": { "type": { "enum": [ "auto", "any", "tool", "none" ], "type": "string" } }, "type": "object" }, "tools": { "items": { "additionalProperties": true, "properties": { "description": { "type": "string" }, "input_schema": { "type": "object" }, "name": { "type": "string" } }, "type": "object" }, "type": "array" } }, "required": [ "model", "messages", "max_tokens" ], "type": "object" }, "MessagesResponse": { "additionalProperties": true, "properties": { "content": { "items": { "additionalProperties": true, "properties": { "text": { "type": "string" }, "type": { "type": "string" } }, "type": "object" }, "type": "array" }, "id": { "type": "string" }, "model": { "type": "string" }, "role": { "type": "string" }, "stop_reason": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "type": { "type": "string" }, "usage": { "$ref": "#/components/schemas/Usage" } }, "type": "object" }, "Method": { "additionalProperties": true, "properties": { "endpoint": { "type": "string" }, "http_method": { "type": "string" }, "input_modalities": { "items": { "type": "string" }, "type": "array" }, "lifecycle_paths": { "items": { "type": "string" }, "type": "array" }, "output_modalities": { "items": { "type": "string" }, "type": "array" }, "path": { "type": "string" }, "price_unit": { "type": "string" }, "pricing": {}, "status": { "type": "string" } }, "type": "object" }, "Model": { "additionalProperties": true, "properties": { "alias_of": { "type": "string" }, "id": { "type": "string" }, "methods": { "items": { "$ref": "#/components/schemas/Method" }, "type": "array" }, "methods_status": { "type": "string" }, "modalities": {}, "pricing": {}, "qualification": { "type": "string" } }, "required": [ "id" ], "type": "object" }, "Models": { "additionalProperties": true, "properties": { "data": { "items": { "$ref": "#/components/schemas/Model" }, "type": "array" }, "object": { "const": "list" } }, "required": [ "object", "data" ], "type": "object" }, "MusicRequest": { "additionalProperties": true, "properties": { "model": { "type": "string" }, "prompt": { "type": "string" } }, "required": [ "model", "prompt" ], "type": "object" }, "MusicResponse": { "additionalProperties": true, "description": "Save every returned clip; each delivered clip is billed.", "properties": { "data": { "items": { "additionalProperties": true, "properties": { "url": { "type": "string" } }, "type": "object" }, "type": "array" } }, "type": "object" }, "Number": { "type": "number" }, "PublicError": { "additionalProperties": true, "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "param": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "reason": { "type": "string" }, "request_id": { "type": "string" }, "type": { "type": "string" } }, "type": "object" }, "ResponsesRequest": { "additionalProperties": true, "properties": { "input": { "anyOf": [ { "type": "string" }, { "items": {}, "type": "array" } ] }, "instructions": { "type": "string" }, "max_output_tokens": { "description": "Requested output-token bound, including reasoning tokens, on routes that support it. On supported capped routes, omitting the parameter uses the documented 4096 bound reduced by a lower model output limit. Some selected routes do not forward this parameter; inspect X-Ailoot-Output-Cap-Requested and X-Ailoot-Output-Cap-Forwarded, or the ailoot-output-cap SSE comment. A requested token limit, the model card maximum, and the monetary reservation are separate quantities.", "type": "integer" }, "model": { "type": "string" }, "previous_response_id": { "type": "string" }, "reasoning": { "additionalProperties": true, "properties": { "effort": { "enum": [ "low", "medium", "high" ], "type": "string" } }, "type": "object" }, "stream": { "type": "boolean" }, "temperature": { "type": "number" }, "text": { "type": "object" }, "tools": { "items": {}, "type": "array" } }, "required": [ "model", "input" ], "type": "object" }, "ResponsesResponse": { "additionalProperties": true, "properties": { "id": { "type": "string" }, "model": { "type": "string" }, "object": { "type": "string" }, "output": { "items": {}, "type": "array" }, "status": { "enum": [ "completed", "incomplete", "failed" ], "type": "string" }, "usage": { "$ref": "#/components/schemas/Usage" } }, "type": "object" }, "SpeechRequest": { "additionalProperties": true, "allOf": [ { "if": { "properties": { "model": { "enum": [ "speech-02-hd", "speech-02-turbo", "speech-2.6-hd", "speech-2.6-turbo", "speech-2.8-hd", "speech-2.8-turbo", "minimax-speech", "minimax-speech-latest", "minimax-speech-turbo" ], "type": "string" } }, "required": [ "model" ] }, "then": { "properties": { "input": { "maxLength": 9999, "type": "string" }, "response_format": { "enum": [ "mp3" ], "type": "string" }, "voice": { "maxLength": 128, "pattern": "^[A-Za-z0-9_-]+$", "type": "string" } }, "required": [ "voice" ] } }, { "if": { "properties": { "model": { "enum": [ "qwen-audio-3.0-tts-plus", "qwen-tts", "qwen-tts-latest" ], "type": "string" } }, "required": [ "model" ] }, "then": { "properties": { "input": { "maxLength": 600, "type": "string" }, "response_format": { "enum": [ "mp3", "wav", "pcm" ], "type": "string" } } } } ], "properties": { "input": { "description": "MiniMax fewer than 10000 characters; Qwen TTS up to 600. Exact model rules apply.", "type": "string" }, "model": { "type": "string" }, "response_format": { "description": "MiniMax only mp3; Qwen mp3/wav/pcm; Gemini wav/json (file link).", "type": "string" }, "sample_rate": { "type": "integer" }, "voice": { "description": "Required for MiniMax speech models: voice ID with Latin letters, digits, _ or -, up to 128 characters. Qwen TTS defaults to longanlingxin; Gemini TTS defaults to Kore.", "type": "string" } }, "required": [ "model", "input" ], "type": "object" }, "String": { "type": "string" }, "SystemOneAnswer": { "additionalProperties": true, "properties": { "choice": { "type": "string" }, "confidence": { "maximum": 1, "minimum": 0, "type": "number" }, "legend": { "type": "object" }, "noul": { "maximum": 1, "minimum": 0, "type": "number" }, "probabilities": { "additionalProperties": { "maximum": 1, "minimum": 0, "type": "number" }, "type": "object" }, "score": { "type": "number" }, "type": { "enum": [ "noul", "choice", "score" ], "type": "string" } }, "type": "object" }, "SystemOneQuestion": { "additionalProperties": true, "allOf": [ { "if": { "properties": { "type": { "const": "choice" } } }, "then": { "properties": { "criteria": { "maxProperties": 255, "type": "object" } }, "required": [ "criteria" ] } }, { "if": { "properties": { "type": { "const": "score" } } }, "then": { "properties": { "criteria": { "items": { "type": "string" }, "maxItems": 10, "minItems": 2, "type": "array" } }, "required": [ "criteria" ] } }, { "if": { "properties": { "type": { "const": "noul" } } }, "then": { "properties": { "criteria": { "type": "object" } } } } ], "description": "noul criteria optional; choice uses up to 255 named options; score uses 2–10 ordered levels.", "properties": { "criteria": { "anyOf": [ { "additionalProperties": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "maxProperties": 255, "type": "object" }, { "items": { "type": "string" }, "maxItems": 10, "type": "array" } ] }, "instructions": { "anyOf": [ { "type": "string" }, { "type": "object" }, { "items": {}, "type": "array" } ] }, "type": { "enum": [ "noul", "choice", "score" ], "type": "string" } }, "required": [ "type", "instructions" ], "type": "object" }, "SystemOneRequest": { "additionalProperties": true, "description": "64K combined request context; state plus longest question up to 32K. Text/JSON only.", "properties": { "model": { "type": "string" }, "questions": { "additionalProperties": { "$ref": "#/components/schemas/SystemOneQuestion" }, "type": "object" }, "state": { "anyOf": [ { "type": "string" }, { "type": "object" }, { "items": {}, "type": "array" } ] } }, "required": [ "model", "state", "questions" ], "type": "object" }, "SystemOneResponse": { "additionalProperties": true, "properties": { "answers": { "additionalProperties": { "$ref": "#/components/schemas/SystemOneAnswer" }, "type": "object" }, "model": { "type": "string" }, "usage": { "$ref": "#/components/schemas/Usage" } }, "type": "object" }, "TranscriptionRequest": { "additionalProperties": true, "properties": { "file": { "contentMediaType": "application/octet-stream", "description": "WAV multipart file. Qwen ASR: complete uncompressed PCM WAV up to 5 minutes, approximately 7.5 MB (up to 10 MB base64). asr-1.0: PCM WAV up to 500 seconds/50 MB. Gemini transcribe: WAV up to 64 MB." }, "model": { "type": "string" }, "response_format": { "description": "Optional; omit or send json.", "enum": [ "json" ], "type": "string" } }, "required": [ "model", "file" ], "type": "object" }, "TranscriptionResponse": { "additionalProperties": true, "properties": { "asset_url": { "type": "string" }, "duration": { "type": "number" }, "task_id": { "type": "string" }, "text": { "type": "string" }, "usage": { "$ref": "#/components/schemas/Usage" } }, "type": "object" }, "Usage": { "additionalProperties": true, "properties": { "cache_creation_input_tokens": { "type": "integer" }, "cache_read_input_tokens": { "type": "integer" }, "completion_tokens": { "type": "integer" }, "input_tokens": { "type": "integer" }, "output_tokens": { "type": "integer" }, "prompt_tokens": { "type": "integer" }, "total_tokens": { "type": "integer" } }, "type": "object" }, "VideoJob": { "additionalProperties": true, "properties": { "content_url": { "type": "string" }, "created_at": {}, "data": { "items": {}, "type": "array" }, "error": {}, "id": { "type": "string" }, "model": { "type": "string" }, "object": { "type": "string" }, "request_id": { "type": "string" }, "result_pending_check": { "type": "boolean" }, "status": { "description": "Model-specific: Grok done; MiniMax/HappyHorse completed; Omni queued/in_progress/completed/partial/content_revoked.", "type": "string" }, "usage": { "$ref": "#/components/schemas/Usage" }, "video": { "additionalProperties": true, "properties": { "duration": { "type": "integer" }, "url": { "type": "string" } }, "type": "object" } }, "type": "object" }, "VideoRequest": { "additionalProperties": true, "properties": { "aspect_ratio": { "type": "string" }, "duration": { "description": "Model-specific: Grok 1–15; MiniMax 6/10 at 768P or 6 at 1080P; HappyHorse 3–15; Google Omni 4/6/8/10 seconds.", "type": "integer" }, "first_frame_image": { "description": "Required for MiniMax Fast; do not use another model family’s image field.", "type": "string" }, "image": { "type": "string" }, "image_urls": { "description": "HappyHorse t2v: no images; i2v: exactly one image and no ratio; r2v: 1–9 images. Model rules apply.", "items": { "type": "string" }, "type": "array" }, "model": { "type": "string" }, "prompt": { "type": "string" }, "resolution": { "description": "Grok 480p/720p/1080p (1080p for video-1.5); MiniMax 768P/1080P; HappyHorse 480P/720P/1080P; Omni 360p/720p.", "type": "string" }, "seconds": { "type": "string" }, "size": { "type": "string" } }, "required": [ "model", "prompt" ], "type": "object" } }, "securitySchemes": { "clientBearer": { "scheme": "bearer", "type": "http" } } }, "externalDocs": { "url": "https://ailoot.ai/docs/en/" }, "info": { "description": "Ailoot client API for products, agents, applications and automations. Use a client Bearer key and choose the exact model/method from /v1/models. Required fields, formats and model-specific conditions follow the public documentation. Preserve the original request ID; creation after an unknown result is never replayed automatically.", "title": "Ailoot client API", "version": "1-current-public-docs" }, "jsonSchemaDialect": "https://spec.openapis.org/oas/3.1/dialect/base", "openapi": "3.1.1", "paths": { "/antigravity/v1beta/models/{model}:generateContent": { "post": { "operationId": "generateContentCompatibility", "parameters": [ { "description": "Use the identifier returned by this API; do not invent or reuse another owner's ID.", "in": "path", "name": "model", "required": true, "schema": { "type": "string" } } ], "requestBody": { "content": { "application/json": { "example": { "contents": [ { "parts": [ { "text": "What is 41 + 52? Answer with a single number." } ], "role": "user" } ], "generationConfig": { "maxOutputTokens": 4096 } }, "schema": { "$ref": "#/components/schemas/GenerateContentRequest" } } }, "required": true }, "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GenerateContentResponse" } } }, "description": "Response shape depends on the selected model and method.", "headers": { "X-Request-ID": { "description": "Preserve the original Request ID.", "schema": { "type": "string" } } } }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Public error classes: invalid_request, context_length_exceeded, content_policy_violation.", "headers": { "Retry-After": { "description": "Wait the returned number of seconds before an allowed retry.", "schema": { "type": "string" } }, "X-Request-ID": { "description": "Preserve the original Request ID.", "schema": { "type": "string" } }, "X-Should-Retry": { "description": "false forbids automatic retry; unknown outcomes must be reconciled.", "schema": { "enum": [ "true", "false" ], "type": "string" } } } }, "401": { "content": { "application/json": { "examples": { "anthropic": { "value": { "error": { "code": "invalid_api_key", "message": "… Nothing was charged. … Request ID: .", "reason": "invalid_api_key", "type": "authentication_error" }, "request_id": "", "type": "error" } }, "gemini": { "value": { "error": { "code": 401, "details": [ { "@type": "type.googleapis.com/google.rpc.ErrorInfo", "domain": "ailoot.ai", "metadata": { "code": "invalid_api_key", "reason": "invalid_api_key", "request_id": "" }, "reason": "INVALID_API_KEY" }, { "@type": "type.googleapis.com/google.rpc.RequestInfo", "requestId": "" } ], "message": "The API key is not valid. Nothing was charged. … Request ID: .", "status": "UNAUTHENTICATED" } } }, "openai": { "value": { "code": "API_KEY_REQUIRED", "error": { "code": "invalid_api_key", "message": "No API key was sent with the request. Nothing was charged. Please check that the full key is sent in the Authorization header as \"Bearer \". Request ID: .", "param": null, "reason": "invalid_api_key", "request_id": "", "type": "invalid_request_error" }, "message": "No API key was sent with the request. Nothing was charged. …" } } }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Public error classes: invalid_api_key, api_key_disabled.", "headers": { "Retry-After": { "description": "Wait the returned number of seconds before an allowed retry.", "schema": { "type": "string" } }, "X-Request-ID": { "description": "Preserve the original Request ID.", "schema": { "type": "string" } }, "X-Should-Retry": { "description": "false forbids automatic retry; unknown outcomes must be reconciled.", "schema": { "enum": [ "true", "false" ], "type": "string" } } } }, "402": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Public error classes: insufficient_balance, insufficient_quota, api_key_quota_exhausted, payment_disputed.", "headers": { "Retry-After": { "description": "Wait the returned number of seconds before an allowed retry.", "schema": { "type": "string" } }, "X-Request-ID": { "description": "Preserve the original Request ID.", "schema": { "type": "string" } }, "X-Should-Retry": { "description": "false forbids automatic retry; unknown outcomes must be reconciled.", "schema": { "enum": [ "true", "false" ], "type": "string" } } } }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Public error classes: api_key_expired, account_inactive, permission_denied.", "headers": { "Retry-After": { "description": "Wait the returned number of seconds before an allowed retry.", "schema": { "type": "string" } }, "X-Request-ID": { "description": "Preserve the original Request ID.", "schema": { "type": "string" } }, "X-Should-Retry": { "description": "false forbids automatic retry; unknown outcomes must be reconciled.", "schema": { "enum": [ "true", "false" ], "type": "string" } } } }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Public error classes: model_not_found, unsupported_endpoint, not_found.", "headers": { "Retry-After": { "description": "Wait the returned number of seconds before an allowed retry.", "schema": { "type": "string" } }, "X-Request-ID": { "description": "Preserve the original Request ID.", "schema": { "type": "string" } }, "X-Should-Retry": { "description": "false forbids automatic retry; unknown outcomes must be reconciled.", "schema": { "enum": [ "true", "false" ], "type": "string" } } } }, "409": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Public error classes: duplicate_request, not_ready, video_not_ready, result_pending_check.", "headers": { "Retry-After": { "description": "Wait the returned number of seconds before an allowed retry.", "schema": { "type": "string" } }, "X-Request-ID": { "description": "Preserve the original Request ID.", "schema": { "type": "string" } }, "X-Should-Retry": { "description": "false forbids automatic retry; unknown outcomes must be reconciled.", "schema": { "enum": [ "true", "false" ], "type": "string" } } } }, "410": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Public error classes: model_retired.", "headers": { "Retry-After": { "description": "Wait the returned number of seconds before an allowed retry.", "schema": { "type": "string" } }, "X-Request-ID": { "description": "Preserve the original Request ID.", "schema": { "type": "string" } }, "X-Should-Retry": { "description": "false forbids automatic retry; unknown outcomes must be reconciled.", "schema": { "enum": [ "true", "false" ], "type": "string" } } } }, "413": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Public error classes: request_too_large.", "headers": { "Retry-After": { "description": "Wait the returned number of seconds before an allowed retry.", "schema": { "type": "string" } }, "X-Request-ID": { "description": "Preserve the original Request ID.", "schema": { "type": "string" } }, "X-Should-Retry": { "description": "false forbids automatic retry; unknown outcomes must be reconciled.", "schema": { "enum": [ "true", "false" ], "type": "string" } } } }, "429": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Public error classes: rate_limit_exceeded, gateway_concurrency_limit, gateway_queue_full, usage_limit_reached.", "headers": { "Retry-After": { "description": "Wait the returned number of seconds before an allowed retry.", "schema": { "type": "string" } }, "X-Request-ID": { "description": "Preserve the original Request ID.", "schema": { "type": "string" } }, "X-Should-Retry": { "description": "false forbids automatic retry; unknown outcomes must be reconciled.", "schema": { "enum": [ "true", "false" ], "type": "string" } } } }, "4XX": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Response shape depends on the selected model and method.", "headers": { "X-Request-ID": { "description": "Preserve the original Request ID.", "schema": { "type": "string" } } } }, "500": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Public error classes: internal_error.", "headers": { "Retry-After": { "description": "Wait the returned number of seconds before an allowed retry.", "schema": { "type": "string" } }, "X-Request-ID": { "description": "Preserve the original Request ID.", "schema": { "type": "string" } }, "X-Should-Retry": { "description": "false forbids automatic retry; unknown outcomes must be reconciled.", "schema": { "enum": [ "true", "false" ], "type": "string" } } } }, "502": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Public error classes: invalid_model_response, empty_response, incomplete_response, result_not_delivered.", "headers": { "Retry-After": { "description": "Wait the returned number of seconds before an allowed retry.", "schema": { "type": "string" } }, "X-Request-ID": { "description": "Preserve the original Request ID.", "schema": { "type": "string" } }, "X-Should-Retry": { "description": "false forbids automatic retry; unknown outcomes must be reconciled.", "schema": { "enum": [ "true", "false" ], "type": "string" } } } }, "503": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Public error classes: model_overloaded, model_unavailable, service_unavailable, charge_not_confirmed, result_pending_check.", "headers": { "Retry-After": { "description": "Wait the returned number of seconds before an allowed retry.", "schema": { "type": "string" } }, "X-Request-ID": { "description": "Preserve the original Request ID.", "schema": { "type": "string" } }, "X-Should-Retry": { "description": "false forbids automatic retry; unknown outcomes must be reconciled.", "schema": { "enum": [ "true", "false" ], "type": "string" } } } }, "504": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Public error classes: model_timeout.", "headers": { "Retry-After": { "description": "Wait the returned number of seconds before an allowed retry.", "schema": { "type": "string" } }, "X-Request-ID": { "description": "Preserve the original Request ID.", "schema": { "type": "string" } }, "X-Should-Retry": { "description": "false forbids automatic retry; unknown outcomes must be reconciled.", "schema": { "enum": [ "true", "false" ], "type": "string" } } } }, "5XX": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Response shape depends on the selected model and method.", "headers": { "X-Request-ID": { "description": "Preserve the original Request ID.", "schema": { "type": "string" } } } } }, "security": [ { "clientBearer": [] } ], "summary": "Generate content with the native protocol" } }, "/v1/audio/speech": { "post": { "operationId": "createSpeech", "requestBody": { "content": { "application/json": { "example": { "input": "Hello! This is a short speech synthesis example.", "model": "qwen-audio-3.0-tts-plus", "response_format": "mp3", "sample_rate": 24000, "voice": "longanlingxin" }, "schema": { "$ref": "#/components/schemas/SpeechRequest" } } }, "required": true }, "responses": { "200": { "content": { "application/json": { "schema": { "description": "Method-specific JSON envelope. Gemini subscription TTS links use data[].url; native URL replies can use top-level audio_url or MiniMax native data.audio. Download each returned signed owned-media URL unchanged, without assuming one universal JSON key." } }, "application/octet-stream": {}, "audio/mpeg": {} }, "description": "Handle the successful body according to Content-Type and the selected method. Binary variants return audio bytes; application/json returns a method-specific envelope. Gemini subscription TTS links use data[].url; native URL replies can use top-level audio_url or MiniMax native data.audio. Download each returned signed owned-media URL unchanged, without assuming one universal JSON key. Usage is recorded separately.", "headers": { "X-Request-ID": { "description": "Preserve the original Request ID.", "schema": { "type": "string" } } } }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Public error classes: invalid_request, context_length_exceeded, content_policy_violation.", "headers": { "Retry-After": { "description": "Wait the returned number of seconds before an allowed retry.", "schema": { "type": "string" } }, "X-Request-ID": { "description": "Preserve the original Request ID.", "schema": { "type": "string" } }, "X-Should-Retry": { "description": "false forbids automatic retry; unknown outcomes must be reconciled.", "schema": { "enum": [ "true", "false" ], "type": "string" } } } }, "401": { "content": { "application/json": { "examples": { "anthropic": { "value": { "error": { "code": "invalid_api_key", "message": "… Nothing was charged. … Request ID: .", "reason": "invalid_api_key", "type": "authentication_error" }, "request_id": "", "type": "error" } }, "gemini": { "value": { "error": { "code": 401, "details": [ { "@type": "type.googleapis.com/google.rpc.ErrorInfo", "domain": "ailoot.ai", "metadata": { "code": "invalid_api_key", "reason": "invalid_api_key", "request_id": "" }, "reason": "INVALID_API_KEY" }, { "@type": "type.googleapis.com/google.rpc.RequestInfo", "requestId": "" } ], "message": "The API key is not valid. Nothing was charged. … Request ID: .", "status": "UNAUTHENTICATED" } } }, "openai": { "value": { "code": "API_KEY_REQUIRED", "error": { "code": "invalid_api_key", "message": "No API key was sent with the request. Nothing was charged. Please check that the full key is sent in the Authorization header as \"Bearer \". Request ID: .", "param": null, "reason": "invalid_api_key", "request_id": "", "type": "invalid_request_error" }, "message": "No API key was sent with the request. Nothing was charged. …" } } }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Public error classes: invalid_api_key, api_key_disabled.", "headers": { "Retry-After": { "description": "Wait the returned number of seconds before an allowed retry.", "schema": { "type": "string" } }, "X-Request-ID": { "description": "Preserve the original Request ID.", "schema": { "type": "string" } }, "X-Should-Retry": { "description": "false forbids automatic retry; unknown outcomes must be reconciled.", "schema": { "enum": [ "true", "false" ], "type": "string" } } } }, "402": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Public error classes: insufficient_balance, insufficient_quota, api_key_quota_exhausted, payment_disputed.", "headers": { "Retry-After": { "description": "Wait the returned number of seconds before an allowed retry.", "schema": { "type": "string" } }, "X-Request-ID": { "description": "Preserve the original Request ID.", "schema": { "type": "string" } }, "X-Should-Retry": { "description": "false forbids automatic retry; unknown outcomes must be reconciled.", "schema": { "enum": [ "true", "false" ], "type": "string" } } } }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Public error classes: api_key_expired, account_inactive, permission_denied.", "headers": { "Retry-After": { "description": "Wait the returned number of seconds before an allowed retry.", "schema": { "type": "string" } }, "X-Request-ID": { "description": "Preserve the original Request ID.", "schema": { "type": "string" } }, "X-Should-Retry": { "description": "false forbids automatic retry; unknown outcomes must be reconciled.", "schema": { "enum": [ "true", "false" ], "type": "string" } } } }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Public error classes: model_not_found, unsupported_endpoint, not_found.", "headers": { "Retry-After": { "description": "Wait the returned number of seconds before an allowed retry.", "schema": { "type": "string" } }, "X-Request-ID": { "description": "Preserve the original Request ID.", "schema": { "type": "string" } }, "X-Should-Retry": { "description": "false forbids automatic retry; unknown outcomes must be reconciled.", "schema": { "enum": [ "true", "false" ], "type": "string" } } } }, "409": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Public error classes: duplicate_request, not_ready, video_not_ready, result_pending_check.", "headers": { "Retry-After": { "description": "Wait the returned number of seconds before an allowed retry.", "schema": { "type": "string" } }, "X-Request-ID": { "description": "Preserve the original Request ID.", "schema": { "type": "string" } }, "X-Should-Retry": { "description": "false forbids automatic retry; unknown outcomes must be reconciled.", "schema": { "enum": [ "true", "false" ], "type": "string" } } } }, "410": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Public error classes: model_retired.", "headers": { "Retry-After": { "description": "Wait the returned number of seconds before an allowed retry.", "schema": { "type": "string" } }, "X-Request-ID": { "description": "Preserve the original Request ID.", "schema": { "type": "string" } }, "X-Should-Retry": { "description": "false forbids automatic retry; unknown outcomes must be reconciled.", "schema": { "enum": [ "true", "false" ], "type": "string" } } } }, "413": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Public error classes: request_too_large.", "headers": { "Retry-After": { "description": "Wait the returned number of seconds before an allowed retry.", "schema": { "type": "string" } }, "X-Request-ID": { "description": "Preserve the original Request ID.", "schema": { "type": "string" } }, "X-Should-Retry": { "description": "false forbids automatic retry; unknown outcomes must be reconciled.", "schema": { "enum": [ "true", "false" ], "type": "string" } } } }, "429": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Public error classes: rate_limit_exceeded, gateway_concurrency_limit, gateway_queue_full, usage_limit_reached.", "headers": { "Retry-After": { "description": "Wait the returned number of seconds before an allowed retry.", "schema": { "type": "string" } }, "X-Request-ID": { "description": "Preserve the original Request ID.", "schema": { "type": "string" } }, "X-Should-Retry": { "description": "false forbids automatic retry; unknown outcomes must be reconciled.", "schema": { "enum": [ "true", "false" ], "type": "string" } } } }, "4XX": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Response shape depends on the selected model and method.", "headers": { "X-Request-ID": { "description": "Preserve the original Request ID.", "schema": { "type": "string" } } } }, "500": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Public error classes: internal_error.", "headers": { "Retry-After": { "description": "Wait the returned number of seconds before an allowed retry.", "schema": { "type": "string" } }, "X-Request-ID": { "description": "Preserve the original Request ID.", "schema": { "type": "string" } }, "X-Should-Retry": { "description": "false forbids automatic retry; unknown outcomes must be reconciled.", "schema": { "enum": [ "true", "false" ], "type": "string" } } } }, "502": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Public error classes: invalid_model_response, empty_response, incomplete_response, result_not_delivered.", "headers": { "Retry-After": { "description": "Wait the returned number of seconds before an allowed retry.", "schema": { "type": "string" } }, "X-Request-ID": { "description": "Preserve the original Request ID.", "schema": { "type": "string" } }, "X-Should-Retry": { "description": "false forbids automatic retry; unknown outcomes must be reconciled.", "schema": { "enum": [ "true", "false" ], "type": "string" } } } }, "503": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Public error classes: model_overloaded, model_unavailable, service_unavailable, charge_not_confirmed, result_pending_check.", "headers": { "Retry-After": { "description": "Wait the returned number of seconds before an allowed retry.", "schema": { "type": "string" } }, "X-Request-ID": { "description": "Preserve the original Request ID.", "schema": { "type": "string" } }, "X-Should-Retry": { "description": "false forbids automatic retry; unknown outcomes must be reconciled.", "schema": { "enum": [ "true", "false" ], "type": "string" } } } }, "504": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Public error classes: model_timeout.", "headers": { "Retry-After": { "description": "Wait the returned number of seconds before an allowed retry.", "schema": { "type": "string" } }, "X-Request-ID": { "description": "Preserve the original Request ID.", "schema": { "type": "string" } }, "X-Should-Retry": { "description": "false forbids automatic retry; unknown outcomes must be reconciled.", "schema": { "enum": [ "true", "false" ], "type": "string" } } } }, "5XX": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Response shape depends on the selected model and method.", "headers": { "X-Request-ID": { "description": "Preserve the original Request ID.", "schema": { "type": "string" } } } } }, "security": [ { "clientBearer": [] } ], "summary": "Synthesize speech audio" } }, "/v1/audio/transcriptions": { "post": { "operationId": "createTranscription", "requestBody": { "content": { "multipart/form-data": { "encoding": { "file": { "contentType": "application/octet-stream" } }, "schema": { "$ref": "#/components/schemas/TranscriptionRequest" } } }, "required": true }, "responses": { "200": { "content": { "application/json": { "example": { "text": "Good afternoon, everyone. Let us start with the results for the week…" }, "schema": { "$ref": "#/components/schemas/TranscriptionResponse" } } }, "description": "Response shape depends on the selected model and method.", "headers": { "X-Request-ID": { "description": "Preserve the original Request ID.", "schema": { "type": "string" } } } }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Public error classes: invalid_request, context_length_exceeded, content_policy_violation.", "headers": { "Retry-After": { "description": "Wait the returned number of seconds before an allowed retry.", "schema": { "type": "string" } }, "X-Request-ID": { "description": "Preserve the original Request ID.", "schema": { "type": "string" } }, "X-Should-Retry": { "description": "false forbids automatic retry; unknown outcomes must be reconciled.", "schema": { "enum": [ "true", "false" ], "type": "string" } } } }, "401": { "content": { "application/json": { "examples": { "anthropic": { "value": { "error": { "code": "invalid_api_key", "message": "… Nothing was charged. … Request ID: .", "reason": "invalid_api_key", "type": "authentication_error" }, "request_id": "", "type": "error" } }, "gemini": { "value": { "error": { "code": 401, "details": [ { "@type": "type.googleapis.com/google.rpc.ErrorInfo", "domain": "ailoot.ai", "metadata": { "code": "invalid_api_key", "reason": "invalid_api_key", "request_id": "" }, "reason": "INVALID_API_KEY" }, { "@type": "type.googleapis.com/google.rpc.RequestInfo", "requestId": "" } ], "message": "The API key is not valid. Nothing was charged. … Request ID: .", "status": "UNAUTHENTICATED" } } }, "openai": { "value": { "code": "API_KEY_REQUIRED", "error": { "code": "invalid_api_key", "message": "No API key was sent with the request. Nothing was charged. Please check that the full key is sent in the Authorization header as \"Bearer \". Request ID: .", "param": null, "reason": "invalid_api_key", "request_id": "", "type": "invalid_request_error" }, "message": "No API key was sent with the request. Nothing was charged. …" } } }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Public error classes: invalid_api_key, api_key_disabled.", "headers": { "Retry-After": { "description": "Wait the returned number of seconds before an allowed retry.", "schema": { "type": "string" } }, "X-Request-ID": { "description": "Preserve the original Request ID.", "schema": { "type": "string" } }, "X-Should-Retry": { "description": "false forbids automatic retry; unknown outcomes must be reconciled.", "schema": { "enum": [ "true", "false" ], "type": "string" } } } }, "402": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Public error classes: insufficient_balance, insufficient_quota, api_key_quota_exhausted, payment_disputed.", "headers": { "Retry-After": { "description": "Wait the returned number of seconds before an allowed retry.", "schema": { "type": "string" } }, "X-Request-ID": { "description": "Preserve the original Request ID.", "schema": { "type": "string" } }, "X-Should-Retry": { "description": "false forbids automatic retry; unknown outcomes must be reconciled.", "schema": { "enum": [ "true", "false" ], "type": "string" } } } }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Public error classes: api_key_expired, account_inactive, permission_denied.", "headers": { "Retry-After": { "description": "Wait the returned number of seconds before an allowed retry.", "schema": { "type": "string" } }, "X-Request-ID": { "description": "Preserve the original Request ID.", "schema": { "type": "string" } }, "X-Should-Retry": { "description": "false forbids automatic retry; unknown outcomes must be reconciled.", "schema": { "enum": [ "true", "false" ], "type": "string" } } } }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Public error classes: model_not_found, unsupported_endpoint, not_found.", "headers": { "Retry-After": { "description": "Wait the returned number of seconds before an allowed retry.", "schema": { "type": "string" } }, "X-Request-ID": { "description": "Preserve the original Request ID.", "schema": { "type": "string" } }, "X-Should-Retry": { "description": "false forbids automatic retry; unknown outcomes must be reconciled.", "schema": { "enum": [ "true", "false" ], "type": "string" } } } }, "409": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Public error classes: duplicate_request, not_ready, video_not_ready, result_pending_check.", "headers": { "Retry-After": { "description": "Wait the returned number of seconds before an allowed retry.", "schema": { "type": "string" } }, "X-Request-ID": { "description": "Preserve the original Request ID.", "schema": { "type": "string" } }, "X-Should-Retry": { "description": "false forbids automatic retry; unknown outcomes must be reconciled.", "schema": { "enum": [ "true", "false" ], "type": "string" } } } }, "410": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Public error classes: model_retired.", "headers": { "Retry-After": { "description": "Wait the returned number of seconds before an allowed retry.", "schema": { "type": "string" } }, "X-Request-ID": { "description": "Preserve the original Request ID.", "schema": { "type": "string" } }, "X-Should-Retry": { "description": "false forbids automatic retry; unknown outcomes must be reconciled.", "schema": { "enum": [ "true", "false" ], "type": "string" } } } }, "413": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Public error classes: request_too_large.", "headers": { "Retry-After": { "description": "Wait the returned number of seconds before an allowed retry.", "schema": { "type": "string" } }, "X-Request-ID": { "description": "Preserve the original Request ID.", "schema": { "type": "string" } }, "X-Should-Retry": { "description": "false forbids automatic retry; unknown outcomes must be reconciled.", "schema": { "enum": [ "true", "false" ], "type": "string" } } } }, "429": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Public error classes: rate_limit_exceeded, gateway_concurrency_limit, gateway_queue_full, usage_limit_reached.", "headers": { "Retry-After": { "description": "Wait the returned number of seconds before an allowed retry.", "schema": { "type": "string" } }, "X-Request-ID": { "description": "Preserve the original Request ID.", "schema": { "type": "string" } }, "X-Should-Retry": { "description": "false forbids automatic retry; unknown outcomes must be reconciled.", "schema": { "enum": [ "true", "false" ], "type": "string" } } } }, "4XX": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Response shape depends on the selected model and method.", "headers": { "X-Request-ID": { "description": "Preserve the original Request ID.", "schema": { "type": "string" } } } }, "500": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Public error classes: internal_error.", "headers": { "Retry-After": { "description": "Wait the returned number of seconds before an allowed retry.", "schema": { "type": "string" } }, "X-Request-ID": { "description": "Preserve the original Request ID.", "schema": { "type": "string" } }, "X-Should-Retry": { "description": "false forbids automatic retry; unknown outcomes must be reconciled.", "schema": { "enum": [ "true", "false" ], "type": "string" } } } }, "502": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Public error classes: invalid_model_response, empty_response, incomplete_response, result_not_delivered.", "headers": { "Retry-After": { "description": "Wait the returned number of seconds before an allowed retry.", "schema": { "type": "string" } }, "X-Request-ID": { "description": "Preserve the original Request ID.", "schema": { "type": "string" } }, "X-Should-Retry": { "description": "false forbids automatic retry; unknown outcomes must be reconciled.", "schema": { "enum": [ "true", "false" ], "type": "string" } } } }, "503": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Public error classes: model_overloaded, model_unavailable, service_unavailable, charge_not_confirmed, result_pending_check.", "headers": { "Retry-After": { "description": "Wait the returned number of seconds before an allowed retry.", "schema": { "type": "string" } }, "X-Request-ID": { "description": "Preserve the original Request ID.", "schema": { "type": "string" } }, "X-Should-Retry": { "description": "false forbids automatic retry; unknown outcomes must be reconciled.", "schema": { "enum": [ "true", "false" ], "type": "string" } } } }, "504": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Public error classes: model_timeout.", "headers": { "Retry-After": { "description": "Wait the returned number of seconds before an allowed retry.", "schema": { "type": "string" } }, "X-Request-ID": { "description": "Preserve the original Request ID.", "schema": { "type": "string" } }, "X-Should-Retry": { "description": "false forbids automatic retry; unknown outcomes must be reconciled.", "schema": { "enum": [ "true", "false" ], "type": "string" } } } }, "5XX": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Response shape depends on the selected model and method.", "headers": { "X-Request-ID": { "description": "Preserve the original Request ID.", "schema": { "type": "string" } } } } }, "security": [ { "clientBearer": [] } ], "summary": "Transcribe uploaded audio" } }, "/v1/chat/completions": { "post": { "operationId": "createChatCompletion", "requestBody": { "content": { "application/json": { "example": { "messages": [ { "content": "What is 17 + 25? Answer with the number only.", "role": "user" } ], "model": "claude-sonnet" }, "schema": { "$ref": "#/components/schemas/ChatRequest" } } }, "required": true }, "responses": { "200": { "content": { "application/json": { "example": { "choices": [ { "finish_reason": "stop", "index": 0, "message": { "content": "An API is an agreement on how one program asks another to do something…", "role": "assistant" } } ], "created": 1790812800, "id": "", "model": "claude-sonnet-5-5", "object": "chat.completion", "usage": { "completion_tokens": 48, "prompt_tokens": 21, "total_tokens": 69 } }, "schema": { "$ref": "#/components/schemas/ChatResponse" } }, "text/event-stream": { "schema": { "description": "SSE frames use the selected protocol; completion and usage must be processed. A 200 response alone is not completion.", "type": "string" } } }, "description": "Response shape depends on the selected model and method.", "headers": { "X-Request-ID": { "description": "Preserve the original Request ID.", "schema": { "type": "string" } } } }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Public error classes: invalid_request, context_length_exceeded, content_policy_violation.", "headers": { "Retry-After": { "description": "Wait the returned number of seconds before an allowed retry.", "schema": { "type": "string" } }, "X-Request-ID": { "description": "Preserve the original Request ID.", "schema": { "type": "string" } }, "X-Should-Retry": { "description": "false forbids automatic retry; unknown outcomes must be reconciled.", "schema": { "enum": [ "true", "false" ], "type": "string" } } } }, "401": { "content": { "application/json": { "examples": { "anthropic": { "value": { "error": { "code": "invalid_api_key", "message": "… Nothing was charged. … Request ID: .", "reason": "invalid_api_key", "type": "authentication_error" }, "request_id": "", "type": "error" } }, "gemini": { "value": { "error": { "code": 401, "details": [ { "@type": "type.googleapis.com/google.rpc.ErrorInfo", "domain": "ailoot.ai", "metadata": { "code": "invalid_api_key", "reason": "invalid_api_key", "request_id": "" }, "reason": "INVALID_API_KEY" }, { "@type": "type.googleapis.com/google.rpc.RequestInfo", "requestId": "" } ], "message": "The API key is not valid. Nothing was charged. … Request ID: .", "status": "UNAUTHENTICATED" } } }, "openai": { "value": { "code": "API_KEY_REQUIRED", "error": { "code": "invalid_api_key", "message": "No API key was sent with the request. Nothing was charged. Please check that the full key is sent in the Authorization header as \"Bearer \". Request ID: .", "param": null, "reason": "invalid_api_key", "request_id": "", "type": "invalid_request_error" }, "message": "No API key was sent with the request. Nothing was charged. …" } } }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Public error classes: invalid_api_key, api_key_disabled.", "headers": { "Retry-After": { "description": "Wait the returned number of seconds before an allowed retry.", "schema": { "type": "string" } }, "X-Request-ID": { "description": "Preserve the original Request ID.", "schema": { "type": "string" } }, "X-Should-Retry": { "description": "false forbids automatic retry; unknown outcomes must be reconciled.", "schema": { "enum": [ "true", "false" ], "type": "string" } } } }, "402": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Public error classes: insufficient_balance, insufficient_quota, api_key_quota_exhausted, payment_disputed.", "headers": { "Retry-After": { "description": "Wait the returned number of seconds before an allowed retry.", "schema": { "type": "string" } }, "X-Request-ID": { "description": "Preserve the original Request ID.", "schema": { "type": "string" } }, "X-Should-Retry": { "description": "false forbids automatic retry; unknown outcomes must be reconciled.", "schema": { "enum": [ "true", "false" ], "type": "string" } } } }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Public error classes: api_key_expired, account_inactive, permission_denied.", "headers": { "Retry-After": { "description": "Wait the returned number of seconds before an allowed retry.", "schema": { "type": "string" } }, "X-Request-ID": { "description": "Preserve the original Request ID.", "schema": { "type": "string" } }, "X-Should-Retry": { "description": "false forbids automatic retry; unknown outcomes must be reconciled.", "schema": { "enum": [ "true", "false" ], "type": "string" } } } }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Public error classes: model_not_found, unsupported_endpoint, not_found.", "headers": { "Retry-After": { "description": "Wait the returned number of seconds before an allowed retry.", "schema": { "type": "string" } }, "X-Request-ID": { "description": "Preserve the original Request ID.", "schema": { "type": "string" } }, "X-Should-Retry": { "description": "false forbids automatic retry; unknown outcomes must be reconciled.", "schema": { "enum": [ "true", "false" ], "type": "string" } } } }, "409": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Public error classes: duplicate_request, not_ready, video_not_ready, result_pending_check.", "headers": { "Retry-After": { "description": "Wait the returned number of seconds before an allowed retry.", "schema": { "type": "string" } }, "X-Request-ID": { "description": "Preserve the original Request ID.", "schema": { "type": "string" } }, "X-Should-Retry": { "description": "false forbids automatic retry; unknown outcomes must be reconciled.", "schema": { "enum": [ "true", "false" ], "type": "string" } } } }, "410": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Public error classes: model_retired.", "headers": { "Retry-After": { "description": "Wait the returned number of seconds before an allowed retry.", "schema": { "type": "string" } }, "X-Request-ID": { "description": "Preserve the original Request ID.", "schema": { "type": "string" } }, "X-Should-Retry": { "description": "false forbids automatic retry; unknown outcomes must be reconciled.", "schema": { "enum": [ "true", "false" ], "type": "string" } } } }, "413": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Public error classes: request_too_large.", "headers": { "Retry-After": { "description": "Wait the returned number of seconds before an allowed retry.", "schema": { "type": "string" } }, "X-Request-ID": { "description": "Preserve the original Request ID.", "schema": { "type": "string" } }, "X-Should-Retry": { "description": "false forbids automatic retry; unknown outcomes must be reconciled.", "schema": { "enum": [ "true", "false" ], "type": "string" } } } }, "429": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Public error classes: rate_limit_exceeded, gateway_concurrency_limit, gateway_queue_full, usage_limit_reached.", "headers": { "Retry-After": { "description": "Wait the returned number of seconds before an allowed retry.", "schema": { "type": "string" } }, "X-Request-ID": { "description": "Preserve the original Request ID.", "schema": { "type": "string" } }, "X-Should-Retry": { "description": "false forbids automatic retry; unknown outcomes must be reconciled.", "schema": { "enum": [ "true", "false" ], "type": "string" } } } }, "4XX": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Response shape depends on the selected model and method.", "headers": { "X-Request-ID": { "description": "Preserve the original Request ID.", "schema": { "type": "string" } } } }, "500": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Public error classes: internal_error.", "headers": { "Retry-After": { "description": "Wait the returned number of seconds before an allowed retry.", "schema": { "type": "string" } }, "X-Request-ID": { "description": "Preserve the original Request ID.", "schema": { "type": "string" } }, "X-Should-Retry": { "description": "false forbids automatic retry; unknown outcomes must be reconciled.", "schema": { "enum": [ "true", "false" ], "type": "string" } } } }, "502": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Public error classes: invalid_model_response, empty_response, incomplete_response, result_not_delivered.", "headers": { "Retry-After": { "description": "Wait the returned number of seconds before an allowed retry.", "schema": { "type": "string" } }, "X-Request-ID": { "description": "Preserve the original Request ID.", "schema": { "type": "string" } }, "X-Should-Retry": { "description": "false forbids automatic retry; unknown outcomes must be reconciled.", "schema": { "enum": [ "true", "false" ], "type": "string" } } } }, "503": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Public error classes: model_overloaded, model_unavailable, service_unavailable, charge_not_confirmed, result_pending_check.", "headers": { "Retry-After": { "description": "Wait the returned number of seconds before an allowed retry.", "schema": { "type": "string" } }, "X-Request-ID": { "description": "Preserve the original Request ID.", "schema": { "type": "string" } }, "X-Should-Retry": { "description": "false forbids automatic retry; unknown outcomes must be reconciled.", "schema": { "enum": [ "true", "false" ], "type": "string" } } } }, "504": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Public error classes: model_timeout.", "headers": { "Retry-After": { "description": "Wait the returned number of seconds before an allowed retry.", "schema": { "type": "string" } }, "X-Request-ID": { "description": "Preserve the original Request ID.", "schema": { "type": "string" } }, "X-Should-Retry": { "description": "false forbids automatic retry; unknown outcomes must be reconciled.", "schema": { "enum": [ "true", "false" ], "type": "string" } } } }, "5XX": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Response shape depends on the selected model and method.", "headers": { "X-Request-ID": { "description": "Preserve the original Request ID.", "schema": { "type": "string" } } } } }, "security": [ { "clientBearer": [] } ], "summary": "Create a chat completion" } }, "/v1/embeddings": { "post": { "operationId": "createEmbeddings", "requestBody": { "content": { "application/json": { "example": { "input": [ "What causes the colors in a rainbow?" ], "input_type": "query", "model": "nvidia/nemotron-3-embed-1b" }, "schema": { "$ref": "#/components/schemas/EmbeddingsRequest" } } }, "required": true }, "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/EmbeddingsResponse" } } }, "description": "Response shape depends on the selected model and method.", "headers": { "X-Request-ID": { "description": "Preserve the original Request ID.", "schema": { "type": "string" } } } }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Public error classes: invalid_request, context_length_exceeded, content_policy_violation.", "headers": { "Retry-After": { "description": "Wait the returned number of seconds before an allowed retry.", "schema": { "type": "string" } }, "X-Request-ID": { "description": "Preserve the original Request ID.", "schema": { "type": "string" } }, "X-Should-Retry": { "description": "false forbids automatic retry; unknown outcomes must be reconciled.", "schema": { "enum": [ "true", "false" ], "type": "string" } } } }, "401": { "content": { "application/json": { "examples": { "anthropic": { "value": { "error": { "code": "invalid_api_key", "message": "… Nothing was charged. … Request ID: .", "reason": "invalid_api_key", "type": "authentication_error" }, "request_id": "", "type": "error" } }, "gemini": { "value": { "error": { "code": 401, "details": [ { "@type": "type.googleapis.com/google.rpc.ErrorInfo", "domain": "ailoot.ai", "metadata": { "code": "invalid_api_key", "reason": "invalid_api_key", "request_id": "" }, "reason": "INVALID_API_KEY" }, { "@type": "type.googleapis.com/google.rpc.RequestInfo", "requestId": "" } ], "message": "The API key is not valid. Nothing was charged. … Request ID: .", "status": "UNAUTHENTICATED" } } }, "openai": { "value": { "code": "API_KEY_REQUIRED", "error": { "code": "invalid_api_key", "message": "No API key was sent with the request. Nothing was charged. Please check that the full key is sent in the Authorization header as \"Bearer \". Request ID: .", "param": null, "reason": "invalid_api_key", "request_id": "", "type": "invalid_request_error" }, "message": "No API key was sent with the request. Nothing was charged. …" } } }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Public error classes: invalid_api_key, api_key_disabled.", "headers": { "Retry-After": { "description": "Wait the returned number of seconds before an allowed retry.", "schema": { "type": "string" } }, "X-Request-ID": { "description": "Preserve the original Request ID.", "schema": { "type": "string" } }, "X-Should-Retry": { "description": "false forbids automatic retry; unknown outcomes must be reconciled.", "schema": { "enum": [ "true", "false" ], "type": "string" } } } }, "402": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Public error classes: insufficient_balance, insufficient_quota, api_key_quota_exhausted, payment_disputed.", "headers": { "Retry-After": { "description": "Wait the returned number of seconds before an allowed retry.", "schema": { "type": "string" } }, "X-Request-ID": { "description": "Preserve the original Request ID.", "schema": { "type": "string" } }, "X-Should-Retry": { "description": "false forbids automatic retry; unknown outcomes must be reconciled.", "schema": { "enum": [ "true", "false" ], "type": "string" } } } }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Public error classes: api_key_expired, account_inactive, permission_denied.", "headers": { "Retry-After": { "description": "Wait the returned number of seconds before an allowed retry.", "schema": { "type": "string" } }, "X-Request-ID": { "description": "Preserve the original Request ID.", "schema": { "type": "string" } }, "X-Should-Retry": { "description": "false forbids automatic retry; unknown outcomes must be reconciled.", "schema": { "enum": [ "true", "false" ], "type": "string" } } } }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Public error classes: model_not_found, unsupported_endpoint, not_found.", "headers": { "Retry-After": { "description": "Wait the returned number of seconds before an allowed retry.", "schema": { "type": "string" } }, "X-Request-ID": { "description": "Preserve the original Request ID.", "schema": { "type": "string" } }, "X-Should-Retry": { "description": "false forbids automatic retry; unknown outcomes must be reconciled.", "schema": { "enum": [ "true", "false" ], "type": "string" } } } }, "409": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Public error classes: duplicate_request, not_ready, video_not_ready, result_pending_check.", "headers": { "Retry-After": { "description": "Wait the returned number of seconds before an allowed retry.", "schema": { "type": "string" } }, "X-Request-ID": { "description": "Preserve the original Request ID.", "schema": { "type": "string" } }, "X-Should-Retry": { "description": "false forbids automatic retry; unknown outcomes must be reconciled.", "schema": { "enum": [ "true", "false" ], "type": "string" } } } }, "410": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Public error classes: model_retired.", "headers": { "Retry-After": { "description": "Wait the returned number of seconds before an allowed retry.", "schema": { "type": "string" } }, "X-Request-ID": { "description": "Preserve the original Request ID.", "schema": { "type": "string" } }, "X-Should-Retry": { "description": "false forbids automatic retry; unknown outcomes must be reconciled.", "schema": { "enum": [ "true", "false" ], "type": "string" } } } }, "413": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Public error classes: request_too_large.", "headers": { "Retry-After": { "description": "Wait the returned number of seconds before an allowed retry.", "schema": { "type": "string" } }, "X-Request-ID": { "description": "Preserve the original Request ID.", "schema": { "type": "string" } }, "X-Should-Retry": { "description": "false forbids automatic retry; unknown outcomes must be reconciled.", "schema": { "enum": [ "true", "false" ], "type": "string" } } } }, "429": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Public error classes: rate_limit_exceeded, gateway_concurrency_limit, gateway_queue_full, usage_limit_reached.", "headers": { "Retry-After": { "description": "Wait the returned number of seconds before an allowed retry.", "schema": { "type": "string" } }, "X-Request-ID": { "description": "Preserve the original Request ID.", "schema": { "type": "string" } }, "X-Should-Retry": { "description": "false forbids automatic retry; unknown outcomes must be reconciled.", "schema": { "enum": [ "true", "false" ], "type": "string" } } } }, "4XX": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Response shape depends on the selected model and method.", "headers": { "X-Request-ID": { "description": "Preserve the original Request ID.", "schema": { "type": "string" } } } }, "500": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Public error classes: internal_error.", "headers": { "Retry-After": { "description": "Wait the returned number of seconds before an allowed retry.", "schema": { "type": "string" } }, "X-Request-ID": { "description": "Preserve the original Request ID.", "schema": { "type": "string" } }, "X-Should-Retry": { "description": "false forbids automatic retry; unknown outcomes must be reconciled.", "schema": { "enum": [ "true", "false" ], "type": "string" } } } }, "502": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Public error classes: invalid_model_response, empty_response, incomplete_response, result_not_delivered.", "headers": { "Retry-After": { "description": "Wait the returned number of seconds before an allowed retry.", "schema": { "type": "string" } }, "X-Request-ID": { "description": "Preserve the original Request ID.", "schema": { "type": "string" } }, "X-Should-Retry": { "description": "false forbids automatic retry; unknown outcomes must be reconciled.", "schema": { "enum": [ "true", "false" ], "type": "string" } } } }, "503": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Public error classes: model_overloaded, model_unavailable, service_unavailable, charge_not_confirmed, result_pending_check.", "headers": { "Retry-After": { "description": "Wait the returned number of seconds before an allowed retry.", "schema": { "type": "string" } }, "X-Request-ID": { "description": "Preserve the original Request ID.", "schema": { "type": "string" } }, "X-Should-Retry": { "description": "false forbids automatic retry; unknown outcomes must be reconciled.", "schema": { "enum": [ "true", "false" ], "type": "string" } } } }, "504": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Public error classes: model_timeout.", "headers": { "Retry-After": { "description": "Wait the returned number of seconds before an allowed retry.", "schema": { "type": "string" } }, "X-Request-ID": { "description": "Preserve the original Request ID.", "schema": { "type": "string" } }, "X-Should-Retry": { "description": "false forbids automatic retry; unknown outcomes must be reconciled.", "schema": { "enum": [ "true", "false" ], "type": "string" } } } }, "5XX": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Response shape depends on the selected model and method.", "headers": { "X-Request-ID": { "description": "Preserve the original Request ID.", "schema": { "type": "string" } } } } }, "security": [ { "clientBearer": [] } ], "summary": "Create text embeddings" } }, "/v1/images/edits": { "post": { "operationId": "editImage", "requestBody": { "content": { "multipart/form-data": { "encoding": { "image": { "contentType": "application/octet-stream" } }, "schema": { "$ref": "#/components/schemas/ImageEditRequest" } } }, "required": true }, "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ImagesResponse" } } }, "description": "Response shape depends on the selected model and method.", "headers": { "X-Request-ID": { "description": "Preserve the original Request ID.", "schema": { "type": "string" } } } }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Public error classes: invalid_request, context_length_exceeded, content_policy_violation.", "headers": { "Retry-After": { "description": "Wait the returned number of seconds before an allowed retry.", "schema": { "type": "string" } }, "X-Request-ID": { "description": "Preserve the original Request ID.", "schema": { "type": "string" } }, "X-Should-Retry": { "description": "false forbids automatic retry; unknown outcomes must be reconciled.", "schema": { "enum": [ "true", "false" ], "type": "string" } } } }, "401": { "content": { "application/json": { "examples": { "anthropic": { "value": { "error": { "code": "invalid_api_key", "message": "… Nothing was charged. … Request ID: .", "reason": "invalid_api_key", "type": "authentication_error" }, "request_id": "", "type": "error" } }, "gemini": { "value": { "error": { "code": 401, "details": [ { "@type": "type.googleapis.com/google.rpc.ErrorInfo", "domain": "ailoot.ai", "metadata": { "code": "invalid_api_key", "reason": "invalid_api_key", "request_id": "" }, "reason": "INVALID_API_KEY" }, { "@type": "type.googleapis.com/google.rpc.RequestInfo", "requestId": "" } ], "message": "The API key is not valid. Nothing was charged. … Request ID: .", "status": "UNAUTHENTICATED" } } }, "openai": { "value": { "code": "API_KEY_REQUIRED", "error": { "code": "invalid_api_key", "message": "No API key was sent with the request. Nothing was charged. Please check that the full key is sent in the Authorization header as \"Bearer \". Request ID: .", "param": null, "reason": "invalid_api_key", "request_id": "", "type": "invalid_request_error" }, "message": "No API key was sent with the request. Nothing was charged. …" } } }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Public error classes: invalid_api_key, api_key_disabled.", "headers": { "Retry-After": { "description": "Wait the returned number of seconds before an allowed retry.", "schema": { "type": "string" } }, "X-Request-ID": { "description": "Preserve the original Request ID.", "schema": { "type": "string" } }, "X-Should-Retry": { "description": "false forbids automatic retry; unknown outcomes must be reconciled.", "schema": { "enum": [ "true", "false" ], "type": "string" } } } }, "402": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Public error classes: insufficient_balance, insufficient_quota, api_key_quota_exhausted, payment_disputed.", "headers": { "Retry-After": { "description": "Wait the returned number of seconds before an allowed retry.", "schema": { "type": "string" } }, "X-Request-ID": { "description": "Preserve the original Request ID.", "schema": { "type": "string" } }, "X-Should-Retry": { "description": "false forbids automatic retry; unknown outcomes must be reconciled.", "schema": { "enum": [ "true", "false" ], "type": "string" } } } }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Public error classes: api_key_expired, account_inactive, permission_denied.", "headers": { "Retry-After": { "description": "Wait the returned number of seconds before an allowed retry.", "schema": { "type": "string" } }, "X-Request-ID": { "description": "Preserve the original Request ID.", "schema": { "type": "string" } }, "X-Should-Retry": { "description": "false forbids automatic retry; unknown outcomes must be reconciled.", "schema": { "enum": [ "true", "false" ], "type": "string" } } } }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Public error classes: model_not_found, unsupported_endpoint, not_found.", "headers": { "Retry-After": { "description": "Wait the returned number of seconds before an allowed retry.", "schema": { "type": "string" } }, "X-Request-ID": { "description": "Preserve the original Request ID.", "schema": { "type": "string" } }, "X-Should-Retry": { "description": "false forbids automatic retry; unknown outcomes must be reconciled.", "schema": { "enum": [ "true", "false" ], "type": "string" } } } }, "409": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Public error classes: duplicate_request, not_ready, video_not_ready, result_pending_check.", "headers": { "Retry-After": { "description": "Wait the returned number of seconds before an allowed retry.", "schema": { "type": "string" } }, "X-Request-ID": { "description": "Preserve the original Request ID.", "schema": { "type": "string" } }, "X-Should-Retry": { "description": "false forbids automatic retry; unknown outcomes must be reconciled.", "schema": { "enum": [ "true", "false" ], "type": "string" } } } }, "410": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Public error classes: model_retired.", "headers": { "Retry-After": { "description": "Wait the returned number of seconds before an allowed retry.", "schema": { "type": "string" } }, "X-Request-ID": { "description": "Preserve the original Request ID.", "schema": { "type": "string" } }, "X-Should-Retry": { "description": "false forbids automatic retry; unknown outcomes must be reconciled.", "schema": { "enum": [ "true", "false" ], "type": "string" } } } }, "413": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Public error classes: request_too_large.", "headers": { "Retry-After": { "description": "Wait the returned number of seconds before an allowed retry.", "schema": { "type": "string" } }, "X-Request-ID": { "description": "Preserve the original Request ID.", "schema": { "type": "string" } }, "X-Should-Retry": { "description": "false forbids automatic retry; unknown outcomes must be reconciled.", "schema": { "enum": [ "true", "false" ], "type": "string" } } } }, "429": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Public error classes: rate_limit_exceeded, gateway_concurrency_limit, gateway_queue_full, usage_limit_reached.", "headers": { "Retry-After": { "description": "Wait the returned number of seconds before an allowed retry.", "schema": { "type": "string" } }, "X-Request-ID": { "description": "Preserve the original Request ID.", "schema": { "type": "string" } }, "X-Should-Retry": { "description": "false forbids automatic retry; unknown outcomes must be reconciled.", "schema": { "enum": [ "true", "false" ], "type": "string" } } } }, "4XX": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Response shape depends on the selected model and method.", "headers": { "X-Request-ID": { "description": "Preserve the original Request ID.", "schema": { "type": "string" } } } }, "500": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Public error classes: internal_error.", "headers": { "Retry-After": { "description": "Wait the returned number of seconds before an allowed retry.", "schema": { "type": "string" } }, "X-Request-ID": { "description": "Preserve the original Request ID.", "schema": { "type": "string" } }, "X-Should-Retry": { "description": "false forbids automatic retry; unknown outcomes must be reconciled.", "schema": { "enum": [ "true", "false" ], "type": "string" } } } }, "502": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Public error classes: invalid_model_response, empty_response, incomplete_response, result_not_delivered.", "headers": { "Retry-After": { "description": "Wait the returned number of seconds before an allowed retry.", "schema": { "type": "string" } }, "X-Request-ID": { "description": "Preserve the original Request ID.", "schema": { "type": "string" } }, "X-Should-Retry": { "description": "false forbids automatic retry; unknown outcomes must be reconciled.", "schema": { "enum": [ "true", "false" ], "type": "string" } } } }, "503": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Public error classes: model_overloaded, model_unavailable, service_unavailable, charge_not_confirmed, result_pending_check.", "headers": { "Retry-After": { "description": "Wait the returned number of seconds before an allowed retry.", "schema": { "type": "string" } }, "X-Request-ID": { "description": "Preserve the original Request ID.", "schema": { "type": "string" } }, "X-Should-Retry": { "description": "false forbids automatic retry; unknown outcomes must be reconciled.", "schema": { "enum": [ "true", "false" ], "type": "string" } } } }, "504": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Public error classes: model_timeout.", "headers": { "Retry-After": { "description": "Wait the returned number of seconds before an allowed retry.", "schema": { "type": "string" } }, "X-Request-ID": { "description": "Preserve the original Request ID.", "schema": { "type": "string" } }, "X-Should-Retry": { "description": "false forbids automatic retry; unknown outcomes must be reconciled.", "schema": { "enum": [ "true", "false" ], "type": "string" } } } }, "5XX": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Response shape depends on the selected model and method.", "headers": { "X-Request-ID": { "description": "Preserve the original Request ID.", "schema": { "type": "string" } } } } }, "security": [ { "clientBearer": [] } ], "summary": "Edit an image" } }, "/v1/images/edits/async": { "post": { "description": "Save task_id and poll_url. Streaming is rejected. A task has processing/completed/failed status and an expires_at field.", "operationId": "createImageEditTask", "requestBody": { "content": { "multipart/form-data": { "encoding": { "image": { "contentType": "application/octet-stream" } }, "schema": { "$ref": "#/components/schemas/ImageEditRequest" } } }, "required": true }, "responses": { "202": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ImageTask" } } }, "description": "Response shape depends on the selected model and method.", "headers": { "Cache-Control": { "example": "no-store", "schema": { "type": "string" } }, "Location": { "schema": { "type": "string" } }, "Retry-After": { "example": "3", "schema": { "type": "string" } }, "X-Request-ID": { "description": "Preserve the original Request ID.", "schema": { "type": "string" } } } }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Public error classes: invalid_request, context_length_exceeded, content_policy_violation.", "headers": { "Retry-After": { "description": "Wait the returned number of seconds before an allowed retry.", "schema": { "type": "string" } }, "X-Request-ID": { "description": "Preserve the original Request ID.", "schema": { "type": "string" } }, "X-Should-Retry": { "description": "false forbids automatic retry; unknown outcomes must be reconciled.", "schema": { "enum": [ "true", "false" ], "type": "string" } } } }, "401": { "content": { "application/json": { "examples": { "anthropic": { "value": { "error": { "code": "invalid_api_key", "message": "… Nothing was charged. … Request ID: .", "reason": "invalid_api_key", "type": "authentication_error" }, "request_id": "", "type": "error" } }, "gemini": { "value": { "error": { "code": 401, "details": [ { "@type": "type.googleapis.com/google.rpc.ErrorInfo", "domain": "ailoot.ai", "metadata": { "code": "invalid_api_key", "reason": "invalid_api_key", "request_id": "" }, "reason": "INVALID_API_KEY" }, { "@type": "type.googleapis.com/google.rpc.RequestInfo", "requestId": "" } ], "message": "The API key is not valid. Nothing was charged. … Request ID: .", "status": "UNAUTHENTICATED" } } }, "openai": { "value": { "code": "API_KEY_REQUIRED", "error": { "code": "invalid_api_key", "message": "No API key was sent with the request. Nothing was charged. Please check that the full key is sent in the Authorization header as \"Bearer \". Request ID: .", "param": null, "reason": "invalid_api_key", "request_id": "", "type": "invalid_request_error" }, "message": "No API key was sent with the request. Nothing was charged. …" } } }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Public error classes: invalid_api_key, api_key_disabled.", "headers": { "Retry-After": { "description": "Wait the returned number of seconds before an allowed retry.", "schema": { "type": "string" } }, "X-Request-ID": { "description": "Preserve the original Request ID.", "schema": { "type": "string" } }, "X-Should-Retry": { "description": "false forbids automatic retry; unknown outcomes must be reconciled.", "schema": { "enum": [ "true", "false" ], "type": "string" } } } }, "402": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Public error classes: insufficient_balance, insufficient_quota, api_key_quota_exhausted, payment_disputed.", "headers": { "Retry-After": { "description": "Wait the returned number of seconds before an allowed retry.", "schema": { "type": "string" } }, "X-Request-ID": { "description": "Preserve the original Request ID.", "schema": { "type": "string" } }, "X-Should-Retry": { "description": "false forbids automatic retry; unknown outcomes must be reconciled.", "schema": { "enum": [ "true", "false" ], "type": "string" } } } }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Public error classes: api_key_expired, account_inactive, permission_denied.", "headers": { "Retry-After": { "description": "Wait the returned number of seconds before an allowed retry.", "schema": { "type": "string" } }, "X-Request-ID": { "description": "Preserve the original Request ID.", "schema": { "type": "string" } }, "X-Should-Retry": { "description": "false forbids automatic retry; unknown outcomes must be reconciled.", "schema": { "enum": [ "true", "false" ], "type": "string" } } } }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Public error classes: model_not_found, unsupported_endpoint, not_found.", "headers": { "Retry-After": { "description": "Wait the returned number of seconds before an allowed retry.", "schema": { "type": "string" } }, "X-Request-ID": { "description": "Preserve the original Request ID.", "schema": { "type": "string" } }, "X-Should-Retry": { "description": "false forbids automatic retry; unknown outcomes must be reconciled.", "schema": { "enum": [ "true", "false" ], "type": "string" } } } }, "409": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Public error classes: duplicate_request, not_ready, video_not_ready, result_pending_check.", "headers": { "Retry-After": { "description": "Wait the returned number of seconds before an allowed retry.", "schema": { "type": "string" } }, "X-Request-ID": { "description": "Preserve the original Request ID.", "schema": { "type": "string" } }, "X-Should-Retry": { "description": "false forbids automatic retry; unknown outcomes must be reconciled.", "schema": { "enum": [ "true", "false" ], "type": "string" } } } }, "410": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Public error classes: model_retired.", "headers": { "Retry-After": { "description": "Wait the returned number of seconds before an allowed retry.", "schema": { "type": "string" } }, "X-Request-ID": { "description": "Preserve the original Request ID.", "schema": { "type": "string" } }, "X-Should-Retry": { "description": "false forbids automatic retry; unknown outcomes must be reconciled.", "schema": { "enum": [ "true", "false" ], "type": "string" } } } }, "413": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Public error classes: request_too_large.", "headers": { "Retry-After": { "description": "Wait the returned number of seconds before an allowed retry.", "schema": { "type": "string" } }, "X-Request-ID": { "description": "Preserve the original Request ID.", "schema": { "type": "string" } }, "X-Should-Retry": { "description": "false forbids automatic retry; unknown outcomes must be reconciled.", "schema": { "enum": [ "true", "false" ], "type": "string" } } } }, "429": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Public error classes: rate_limit_exceeded, gateway_concurrency_limit, gateway_queue_full, usage_limit_reached.", "headers": { "Retry-After": { "description": "Wait the returned number of seconds before an allowed retry.", "schema": { "type": "string" } }, "X-Request-ID": { "description": "Preserve the original Request ID.", "schema": { "type": "string" } }, "X-Should-Retry": { "description": "false forbids automatic retry; unknown outcomes must be reconciled.", "schema": { "enum": [ "true", "false" ], "type": "string" } } } }, "4XX": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Response shape depends on the selected model and method.", "headers": { "X-Request-ID": { "description": "Preserve the original Request ID.", "schema": { "type": "string" } } } }, "500": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Public error classes: internal_error.", "headers": { "Retry-After": { "description": "Wait the returned number of seconds before an allowed retry.", "schema": { "type": "string" } }, "X-Request-ID": { "description": "Preserve the original Request ID.", "schema": { "type": "string" } }, "X-Should-Retry": { "description": "false forbids automatic retry; unknown outcomes must be reconciled.", "schema": { "enum": [ "true", "false" ], "type": "string" } } } }, "502": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Public error classes: invalid_model_response, empty_response, incomplete_response, result_not_delivered.", "headers": { "Retry-After": { "description": "Wait the returned number of seconds before an allowed retry.", "schema": { "type": "string" } }, "X-Request-ID": { "description": "Preserve the original Request ID.", "schema": { "type": "string" } }, "X-Should-Retry": { "description": "false forbids automatic retry; unknown outcomes must be reconciled.", "schema": { "enum": [ "true", "false" ], "type": "string" } } } }, "503": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Public error classes: model_overloaded, model_unavailable, service_unavailable, charge_not_confirmed, result_pending_check.", "headers": { "Retry-After": { "description": "Wait the returned number of seconds before an allowed retry.", "schema": { "type": "string" } }, "X-Request-ID": { "description": "Preserve the original Request ID.", "schema": { "type": "string" } }, "X-Should-Retry": { "description": "false forbids automatic retry; unknown outcomes must be reconciled.", "schema": { "enum": [ "true", "false" ], "type": "string" } } } }, "504": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Public error classes: model_timeout.", "headers": { "Retry-After": { "description": "Wait the returned number of seconds before an allowed retry.", "schema": { "type": "string" } }, "X-Request-ID": { "description": "Preserve the original Request ID.", "schema": { "type": "string" } }, "X-Should-Retry": { "description": "false forbids automatic retry; unknown outcomes must be reconciled.", "schema": { "enum": [ "true", "false" ], "type": "string" } } } }, "5XX": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Response shape depends on the selected model and method.", "headers": { "X-Request-ID": { "description": "Preserve the original Request ID.", "schema": { "type": "string" } } } } }, "security": [ { "clientBearer": [] } ], "summary": "Start an asynchronous image task" } }, "/v1/images/generations": { "post": { "operationId": "createImage", "requestBody": { "content": { "application/json": { "example": { "model": "qwen-image", "n": 1, "prompt": "A single blue ceramic cup on a light background, no text.", "response_format": "url", "size": "1024x1024" }, "schema": { "$ref": "#/components/schemas/ImageRequest" } } }, "required": true }, "responses": { "200": { "content": { "application/json": { "example": { "created": 1790812800, "data": [ { "url": "" } ], "usage": { "input_tokens": 18, "output_tokens": 1056 } }, "schema": { "$ref": "#/components/schemas/ImagesResponse" } } }, "description": "Response shape depends on the selected model and method.", "headers": { "X-Request-ID": { "description": "Preserve the original Request ID.", "schema": { "type": "string" } } } }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Public error classes: invalid_request, context_length_exceeded, content_policy_violation.", "headers": { "Retry-After": { "description": "Wait the returned number of seconds before an allowed retry.", "schema": { "type": "string" } }, "X-Request-ID": { "description": "Preserve the original Request ID.", "schema": { "type": "string" } }, "X-Should-Retry": { "description": "false forbids automatic retry; unknown outcomes must be reconciled.", "schema": { "enum": [ "true", "false" ], "type": "string" } } } }, "401": { "content": { "application/json": { "examples": { "anthropic": { "value": { "error": { "code": "invalid_api_key", "message": "… Nothing was charged. … Request ID: .", "reason": "invalid_api_key", "type": "authentication_error" }, "request_id": "", "type": "error" } }, "gemini": { "value": { "error": { "code": 401, "details": [ { "@type": "type.googleapis.com/google.rpc.ErrorInfo", "domain": "ailoot.ai", "metadata": { "code": "invalid_api_key", "reason": "invalid_api_key", "request_id": "" }, "reason": "INVALID_API_KEY" }, { "@type": "type.googleapis.com/google.rpc.RequestInfo", "requestId": "" } ], "message": "The API key is not valid. Nothing was charged. … Request ID: .", "status": "UNAUTHENTICATED" } } }, "openai": { "value": { "code": "API_KEY_REQUIRED", "error": { "code": "invalid_api_key", "message": "No API key was sent with the request. Nothing was charged. Please check that the full key is sent in the Authorization header as \"Bearer \". Request ID: .", "param": null, "reason": "invalid_api_key", "request_id": "", "type": "invalid_request_error" }, "message": "No API key was sent with the request. Nothing was charged. …" } } }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Public error classes: invalid_api_key, api_key_disabled.", "headers": { "Retry-After": { "description": "Wait the returned number of seconds before an allowed retry.", "schema": { "type": "string" } }, "X-Request-ID": { "description": "Preserve the original Request ID.", "schema": { "type": "string" } }, "X-Should-Retry": { "description": "false forbids automatic retry; unknown outcomes must be reconciled.", "schema": { "enum": [ "true", "false" ], "type": "string" } } } }, "402": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Public error classes: insufficient_balance, insufficient_quota, api_key_quota_exhausted, payment_disputed.", "headers": { "Retry-After": { "description": "Wait the returned number of seconds before an allowed retry.", "schema": { "type": "string" } }, "X-Request-ID": { "description": "Preserve the original Request ID.", "schema": { "type": "string" } }, "X-Should-Retry": { "description": "false forbids automatic retry; unknown outcomes must be reconciled.", "schema": { "enum": [ "true", "false" ], "type": "string" } } } }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Public error classes: api_key_expired, account_inactive, permission_denied.", "headers": { "Retry-After": { "description": "Wait the returned number of seconds before an allowed retry.", "schema": { "type": "string" } }, "X-Request-ID": { "description": "Preserve the original Request ID.", "schema": { "type": "string" } }, "X-Should-Retry": { "description": "false forbids automatic retry; unknown outcomes must be reconciled.", "schema": { "enum": [ "true", "false" ], "type": "string" } } } }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Public error classes: model_not_found, unsupported_endpoint, not_found.", "headers": { "Retry-After": { "description": "Wait the returned number of seconds before an allowed retry.", "schema": { "type": "string" } }, "X-Request-ID": { "description": "Preserve the original Request ID.", "schema": { "type": "string" } }, "X-Should-Retry": { "description": "false forbids automatic retry; unknown outcomes must be reconciled.", "schema": { "enum": [ "true", "false" ], "type": "string" } } } }, "409": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Public error classes: duplicate_request, not_ready, video_not_ready, result_pending_check.", "headers": { "Retry-After": { "description": "Wait the returned number of seconds before an allowed retry.", "schema": { "type": "string" } }, "X-Request-ID": { "description": "Preserve the original Request ID.", "schema": { "type": "string" } }, "X-Should-Retry": { "description": "false forbids automatic retry; unknown outcomes must be reconciled.", "schema": { "enum": [ "true", "false" ], "type": "string" } } } }, "410": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Public error classes: model_retired.", "headers": { "Retry-After": { "description": "Wait the returned number of seconds before an allowed retry.", "schema": { "type": "string" } }, "X-Request-ID": { "description": "Preserve the original Request ID.", "schema": { "type": "string" } }, "X-Should-Retry": { "description": "false forbids automatic retry; unknown outcomes must be reconciled.", "schema": { "enum": [ "true", "false" ], "type": "string" } } } }, "413": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Public error classes: request_too_large.", "headers": { "Retry-After": { "description": "Wait the returned number of seconds before an allowed retry.", "schema": { "type": "string" } }, "X-Request-ID": { "description": "Preserve the original Request ID.", "schema": { "type": "string" } }, "X-Should-Retry": { "description": "false forbids automatic retry; unknown outcomes must be reconciled.", "schema": { "enum": [ "true", "false" ], "type": "string" } } } }, "429": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Public error classes: rate_limit_exceeded, gateway_concurrency_limit, gateway_queue_full, usage_limit_reached.", "headers": { "Retry-After": { "description": "Wait the returned number of seconds before an allowed retry.", "schema": { "type": "string" } }, "X-Request-ID": { "description": "Preserve the original Request ID.", "schema": { "type": "string" } }, "X-Should-Retry": { "description": "false forbids automatic retry; unknown outcomes must be reconciled.", "schema": { "enum": [ "true", "false" ], "type": "string" } } } }, "4XX": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Response shape depends on the selected model and method.", "headers": { "X-Request-ID": { "description": "Preserve the original Request ID.", "schema": { "type": "string" } } } }, "500": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Public error classes: internal_error.", "headers": { "Retry-After": { "description": "Wait the returned number of seconds before an allowed retry.", "schema": { "type": "string" } }, "X-Request-ID": { "description": "Preserve the original Request ID.", "schema": { "type": "string" } }, "X-Should-Retry": { "description": "false forbids automatic retry; unknown outcomes must be reconciled.", "schema": { "enum": [ "true", "false" ], "type": "string" } } } }, "502": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Public error classes: invalid_model_response, empty_response, incomplete_response, result_not_delivered.", "headers": { "Retry-After": { "description": "Wait the returned number of seconds before an allowed retry.", "schema": { "type": "string" } }, "X-Request-ID": { "description": "Preserve the original Request ID.", "schema": { "type": "string" } }, "X-Should-Retry": { "description": "false forbids automatic retry; unknown outcomes must be reconciled.", "schema": { "enum": [ "true", "false" ], "type": "string" } } } }, "503": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Public error classes: model_overloaded, model_unavailable, service_unavailable, charge_not_confirmed, result_pending_check.", "headers": { "Retry-After": { "description": "Wait the returned number of seconds before an allowed retry.", "schema": { "type": "string" } }, "X-Request-ID": { "description": "Preserve the original Request ID.", "schema": { "type": "string" } }, "X-Should-Retry": { "description": "false forbids automatic retry; unknown outcomes must be reconciled.", "schema": { "enum": [ "true", "false" ], "type": "string" } } } }, "504": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Public error classes: model_timeout.", "headers": { "Retry-After": { "description": "Wait the returned number of seconds before an allowed retry.", "schema": { "type": "string" } }, "X-Request-ID": { "description": "Preserve the original Request ID.", "schema": { "type": "string" } }, "X-Should-Retry": { "description": "false forbids automatic retry; unknown outcomes must be reconciled.", "schema": { "enum": [ "true", "false" ], "type": "string" } } } }, "5XX": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Response shape depends on the selected model and method.", "headers": { "X-Request-ID": { "description": "Preserve the original Request ID.", "schema": { "type": "string" } } } } }, "security": [ { "clientBearer": [] } ], "summary": "Generate images" } }, "/v1/images/generations/async": { "post": { "description": "Save task_id and poll_url. Streaming is rejected. A task has processing/completed/failed status and an expires_at field.", "operationId": "createImageTask", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ImageRequest" } } }, "required": true }, "responses": { "202": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ImageTask" } } }, "description": "Response shape depends on the selected model and method.", "headers": { "Cache-Control": { "example": "no-store", "schema": { "type": "string" } }, "Location": { "schema": { "type": "string" } }, "Retry-After": { "example": "3", "schema": { "type": "string" } }, "X-Request-ID": { "description": "Preserve the original Request ID.", "schema": { "type": "string" } } } }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Public error classes: invalid_request, context_length_exceeded, content_policy_violation.", "headers": { "Retry-After": { "description": "Wait the returned number of seconds before an allowed retry.", "schema": { "type": "string" } }, "X-Request-ID": { "description": "Preserve the original Request ID.", "schema": { "type": "string" } }, "X-Should-Retry": { "description": "false forbids automatic retry; unknown outcomes must be reconciled.", "schema": { "enum": [ "true", "false" ], "type": "string" } } } }, "401": { "content": { "application/json": { "examples": { "anthropic": { "value": { "error": { "code": "invalid_api_key", "message": "… Nothing was charged. … Request ID: .", "reason": "invalid_api_key", "type": "authentication_error" }, "request_id": "", "type": "error" } }, "gemini": { "value": { "error": { "code": 401, "details": [ { "@type": "type.googleapis.com/google.rpc.ErrorInfo", "domain": "ailoot.ai", "metadata": { "code": "invalid_api_key", "reason": "invalid_api_key", "request_id": "" }, "reason": "INVALID_API_KEY" }, { "@type": "type.googleapis.com/google.rpc.RequestInfo", "requestId": "" } ], "message": "The API key is not valid. Nothing was charged. … Request ID: .", "status": "UNAUTHENTICATED" } } }, "openai": { "value": { "code": "API_KEY_REQUIRED", "error": { "code": "invalid_api_key", "message": "No API key was sent with the request. Nothing was charged. Please check that the full key is sent in the Authorization header as \"Bearer \". Request ID: .", "param": null, "reason": "invalid_api_key", "request_id": "", "type": "invalid_request_error" }, "message": "No API key was sent with the request. Nothing was charged. …" } } }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Public error classes: invalid_api_key, api_key_disabled.", "headers": { "Retry-After": { "description": "Wait the returned number of seconds before an allowed retry.", "schema": { "type": "string" } }, "X-Request-ID": { "description": "Preserve the original Request ID.", "schema": { "type": "string" } }, "X-Should-Retry": { "description": "false forbids automatic retry; unknown outcomes must be reconciled.", "schema": { "enum": [ "true", "false" ], "type": "string" } } } }, "402": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Public error classes: insufficient_balance, insufficient_quota, api_key_quota_exhausted, payment_disputed.", "headers": { "Retry-After": { "description": "Wait the returned number of seconds before an allowed retry.", "schema": { "type": "string" } }, "X-Request-ID": { "description": "Preserve the original Request ID.", "schema": { "type": "string" } }, "X-Should-Retry": { "description": "false forbids automatic retry; unknown outcomes must be reconciled.", "schema": { "enum": [ "true", "false" ], "type": "string" } } } }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Public error classes: api_key_expired, account_inactive, permission_denied.", "headers": { "Retry-After": { "description": "Wait the returned number of seconds before an allowed retry.", "schema": { "type": "string" } }, "X-Request-ID": { "description": "Preserve the original Request ID.", "schema": { "type": "string" } }, "X-Should-Retry": { "description": "false forbids automatic retry; unknown outcomes must be reconciled.", "schema": { "enum": [ "true", "false" ], "type": "string" } } } }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Public error classes: model_not_found, unsupported_endpoint, not_found.", "headers": { "Retry-After": { "description": "Wait the returned number of seconds before an allowed retry.", "schema": { "type": "string" } }, "X-Request-ID": { "description": "Preserve the original Request ID.", "schema": { "type": "string" } }, "X-Should-Retry": { "description": "false forbids automatic retry; unknown outcomes must be reconciled.", "schema": { "enum": [ "true", "false" ], "type": "string" } } } }, "409": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Public error classes: duplicate_request, not_ready, video_not_ready, result_pending_check.", "headers": { "Retry-After": { "description": "Wait the returned number of seconds before an allowed retry.", "schema": { "type": "string" } }, "X-Request-ID": { "description": "Preserve the original Request ID.", "schema": { "type": "string" } }, "X-Should-Retry": { "description": "false forbids automatic retry; unknown outcomes must be reconciled.", "schema": { "enum": [ "true", "false" ], "type": "string" } } } }, "410": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Public error classes: model_retired.", "headers": { "Retry-After": { "description": "Wait the returned number of seconds before an allowed retry.", "schema": { "type": "string" } }, "X-Request-ID": { "description": "Preserve the original Request ID.", "schema": { "type": "string" } }, "X-Should-Retry": { "description": "false forbids automatic retry; unknown outcomes must be reconciled.", "schema": { "enum": [ "true", "false" ], "type": "string" } } } }, "413": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Public error classes: request_too_large.", "headers": { "Retry-After": { "description": "Wait the returned number of seconds before an allowed retry.", "schema": { "type": "string" } }, "X-Request-ID": { "description": "Preserve the original Request ID.", "schema": { "type": "string" } }, "X-Should-Retry": { "description": "false forbids automatic retry; unknown outcomes must be reconciled.", "schema": { "enum": [ "true", "false" ], "type": "string" } } } }, "429": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Public error classes: rate_limit_exceeded, gateway_concurrency_limit, gateway_queue_full, usage_limit_reached.", "headers": { "Retry-After": { "description": "Wait the returned number of seconds before an allowed retry.", "schema": { "type": "string" } }, "X-Request-ID": { "description": "Preserve the original Request ID.", "schema": { "type": "string" } }, "X-Should-Retry": { "description": "false forbids automatic retry; unknown outcomes must be reconciled.", "schema": { "enum": [ "true", "false" ], "type": "string" } } } }, "4XX": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Response shape depends on the selected model and method.", "headers": { "X-Request-ID": { "description": "Preserve the original Request ID.", "schema": { "type": "string" } } } }, "500": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Public error classes: internal_error.", "headers": { "Retry-After": { "description": "Wait the returned number of seconds before an allowed retry.", "schema": { "type": "string" } }, "X-Request-ID": { "description": "Preserve the original Request ID.", "schema": { "type": "string" } }, "X-Should-Retry": { "description": "false forbids automatic retry; unknown outcomes must be reconciled.", "schema": { "enum": [ "true", "false" ], "type": "string" } } } }, "502": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Public error classes: invalid_model_response, empty_response, incomplete_response, result_not_delivered.", "headers": { "Retry-After": { "description": "Wait the returned number of seconds before an allowed retry.", "schema": { "type": "string" } }, "X-Request-ID": { "description": "Preserve the original Request ID.", "schema": { "type": "string" } }, "X-Should-Retry": { "description": "false forbids automatic retry; unknown outcomes must be reconciled.", "schema": { "enum": [ "true", "false" ], "type": "string" } } } }, "503": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Public error classes: model_overloaded, model_unavailable, service_unavailable, charge_not_confirmed, result_pending_check.", "headers": { "Retry-After": { "description": "Wait the returned number of seconds before an allowed retry.", "schema": { "type": "string" } }, "X-Request-ID": { "description": "Preserve the original Request ID.", "schema": { "type": "string" } }, "X-Should-Retry": { "description": "false forbids automatic retry; unknown outcomes must be reconciled.", "schema": { "enum": [ "true", "false" ], "type": "string" } } } }, "504": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Public error classes: model_timeout.", "headers": { "Retry-After": { "description": "Wait the returned number of seconds before an allowed retry.", "schema": { "type": "string" } }, "X-Request-ID": { "description": "Preserve the original Request ID.", "schema": { "type": "string" } }, "X-Should-Retry": { "description": "false forbids automatic retry; unknown outcomes must be reconciled.", "schema": { "enum": [ "true", "false" ], "type": "string" } } } }, "5XX": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Response shape depends on the selected model and method.", "headers": { "X-Request-ID": { "description": "Preserve the original Request ID.", "schema": { "type": "string" } } } } }, "security": [ { "clientBearer": [] } ], "summary": "Start an asynchronous image task" } }, "/v1/images/tasks/{task_id}": { "get": { "operationId": "getImageTask", "parameters": [ { "description": "Use the identifier returned by this API; do not invent or reuse another owner's ID.", "in": "path", "name": "task_id", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ImageTask" } } }, "description": "Response shape depends on the selected model and method.", "headers": { "X-Request-ID": { "description": "Preserve the original Request ID.", "schema": { "type": "string" } } } }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Public error classes: invalid_request, context_length_exceeded, content_policy_violation.", "headers": { "Retry-After": { "description": "Wait the returned number of seconds before an allowed retry.", "schema": { "type": "string" } }, "X-Request-ID": { "description": "Preserve the original Request ID.", "schema": { "type": "string" } }, "X-Should-Retry": { "description": "false forbids automatic retry; unknown outcomes must be reconciled.", "schema": { "enum": [ "true", "false" ], "type": "string" } } } }, "401": { "content": { "application/json": { "examples": { "anthropic": { "value": { "error": { "code": "invalid_api_key", "message": "… Nothing was charged. … Request ID: .", "reason": "invalid_api_key", "type": "authentication_error" }, "request_id": "", "type": "error" } }, "gemini": { "value": { "error": { "code": 401, "details": [ { "@type": "type.googleapis.com/google.rpc.ErrorInfo", "domain": "ailoot.ai", "metadata": { "code": "invalid_api_key", "reason": "invalid_api_key", "request_id": "" }, "reason": "INVALID_API_KEY" }, { "@type": "type.googleapis.com/google.rpc.RequestInfo", "requestId": "" } ], "message": "The API key is not valid. Nothing was charged. … Request ID: .", "status": "UNAUTHENTICATED" } } }, "openai": { "value": { "code": "API_KEY_REQUIRED", "error": { "code": "invalid_api_key", "message": "No API key was sent with the request. Nothing was charged. Please check that the full key is sent in the Authorization header as \"Bearer \". Request ID: .", "param": null, "reason": "invalid_api_key", "request_id": "", "type": "invalid_request_error" }, "message": "No API key was sent with the request. Nothing was charged. …" } } }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Public error classes: invalid_api_key, api_key_disabled.", "headers": { "Retry-After": { "description": "Wait the returned number of seconds before an allowed retry.", "schema": { "type": "string" } }, "X-Request-ID": { "description": "Preserve the original Request ID.", "schema": { "type": "string" } }, "X-Should-Retry": { "description": "false forbids automatic retry; unknown outcomes must be reconciled.", "schema": { "enum": [ "true", "false" ], "type": "string" } } } }, "402": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Public error classes: insufficient_balance, insufficient_quota, api_key_quota_exhausted, payment_disputed.", "headers": { "Retry-After": { "description": "Wait the returned number of seconds before an allowed retry.", "schema": { "type": "string" } }, "X-Request-ID": { "description": "Preserve the original Request ID.", "schema": { "type": "string" } }, "X-Should-Retry": { "description": "false forbids automatic retry; unknown outcomes must be reconciled.", "schema": { "enum": [ "true", "false" ], "type": "string" } } } }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Public error classes: api_key_expired, account_inactive, permission_denied.", "headers": { "Retry-After": { "description": "Wait the returned number of seconds before an allowed retry.", "schema": { "type": "string" } }, "X-Request-ID": { "description": "Preserve the original Request ID.", "schema": { "type": "string" } }, "X-Should-Retry": { "description": "false forbids automatic retry; unknown outcomes must be reconciled.", "schema": { "enum": [ "true", "false" ], "type": "string" } } } }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Public error classes: model_not_found, unsupported_endpoint, not_found.", "headers": { "Retry-After": { "description": "Wait the returned number of seconds before an allowed retry.", "schema": { "type": "string" } }, "X-Request-ID": { "description": "Preserve the original Request ID.", "schema": { "type": "string" } }, "X-Should-Retry": { "description": "false forbids automatic retry; unknown outcomes must be reconciled.", "schema": { "enum": [ "true", "false" ], "type": "string" } } } }, "409": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Public error classes: duplicate_request, not_ready, video_not_ready, result_pending_check.", "headers": { "Retry-After": { "description": "Wait the returned number of seconds before an allowed retry.", "schema": { "type": "string" } }, "X-Request-ID": { "description": "Preserve the original Request ID.", "schema": { "type": "string" } }, "X-Should-Retry": { "description": "false forbids automatic retry; unknown outcomes must be reconciled.", "schema": { "enum": [ "true", "false" ], "type": "string" } } } }, "410": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Public error classes: model_retired.", "headers": { "Retry-After": { "description": "Wait the returned number of seconds before an allowed retry.", "schema": { "type": "string" } }, "X-Request-ID": { "description": "Preserve the original Request ID.", "schema": { "type": "string" } }, "X-Should-Retry": { "description": "false forbids automatic retry; unknown outcomes must be reconciled.", "schema": { "enum": [ "true", "false" ], "type": "string" } } } }, "413": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Public error classes: request_too_large.", "headers": { "Retry-After": { "description": "Wait the returned number of seconds before an allowed retry.", "schema": { "type": "string" } }, "X-Request-ID": { "description": "Preserve the original Request ID.", "schema": { "type": "string" } }, "X-Should-Retry": { "description": "false forbids automatic retry; unknown outcomes must be reconciled.", "schema": { "enum": [ "true", "false" ], "type": "string" } } } }, "429": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Public error classes: rate_limit_exceeded, gateway_concurrency_limit, gateway_queue_full, usage_limit_reached.", "headers": { "Retry-After": { "description": "Wait the returned number of seconds before an allowed retry.", "schema": { "type": "string" } }, "X-Request-ID": { "description": "Preserve the original Request ID.", "schema": { "type": "string" } }, "X-Should-Retry": { "description": "false forbids automatic retry; unknown outcomes must be reconciled.", "schema": { "enum": [ "true", "false" ], "type": "string" } } } }, "4XX": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Response shape depends on the selected model and method.", "headers": { "X-Request-ID": { "description": "Preserve the original Request ID.", "schema": { "type": "string" } } } }, "500": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Public error classes: internal_error.", "headers": { "Retry-After": { "description": "Wait the returned number of seconds before an allowed retry.", "schema": { "type": "string" } }, "X-Request-ID": { "description": "Preserve the original Request ID.", "schema": { "type": "string" } }, "X-Should-Retry": { "description": "false forbids automatic retry; unknown outcomes must be reconciled.", "schema": { "enum": [ "true", "false" ], "type": "string" } } } }, "502": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Public error classes: invalid_model_response, empty_response, incomplete_response, result_not_delivered.", "headers": { "Retry-After": { "description": "Wait the returned number of seconds before an allowed retry.", "schema": { "type": "string" } }, "X-Request-ID": { "description": "Preserve the original Request ID.", "schema": { "type": "string" } }, "X-Should-Retry": { "description": "false forbids automatic retry; unknown outcomes must be reconciled.", "schema": { "enum": [ "true", "false" ], "type": "string" } } } }, "503": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Public error classes: model_overloaded, model_unavailable, service_unavailable, charge_not_confirmed, result_pending_check.", "headers": { "Retry-After": { "description": "Wait the returned number of seconds before an allowed retry.", "schema": { "type": "string" } }, "X-Request-ID": { "description": "Preserve the original Request ID.", "schema": { "type": "string" } }, "X-Should-Retry": { "description": "false forbids automatic retry; unknown outcomes must be reconciled.", "schema": { "enum": [ "true", "false" ], "type": "string" } } } }, "504": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Public error classes: model_timeout.", "headers": { "Retry-After": { "description": "Wait the returned number of seconds before an allowed retry.", "schema": { "type": "string" } }, "X-Request-ID": { "description": "Preserve the original Request ID.", "schema": { "type": "string" } }, "X-Should-Retry": { "description": "false forbids automatic retry; unknown outcomes must be reconciled.", "schema": { "enum": [ "true", "false" ], "type": "string" } } } }, "5XX": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Response shape depends on the selected model and method.", "headers": { "X-Request-ID": { "description": "Preserve the original Request ID.", "schema": { "type": "string" } } } } }, "security": [ { "clientBearer": [] } ], "summary": "Read the original image task" } }, "/v1/messages": { "post": { "operationId": "createMessage", "parameters": [ { "example": "2023-06-01", "in": "header", "name": "anthropic-version", "required": false, "schema": { "type": "string" } } ], "requestBody": { "content": { "application/json": { "example": { "max_tokens": 16000, "messages": [ { "content": "What is 17 + 25? Answer with the number only.", "role": "user" } ], "model": "kimi-k3" }, "schema": { "$ref": "#/components/schemas/MessagesRequest" } } }, "required": true }, "responses": { "200": { "content": { "application/json": { "example": { "content": [ { "text": "Hello! I can write and explain code, answer questions…", "type": "text" } ], "id": "", "model": "claude-sonnet-5-5", "role": "assistant", "stop_reason": "end_turn", "type": "message", "usage": { "input_tokens": 14, "output_tokens": 52 } }, "schema": { "$ref": "#/components/schemas/MessagesResponse" } }, "text/event-stream": { "schema": { "description": "SSE frames use the selected protocol; completion and usage must be processed. A 200 response alone is not completion.", "type": "string" } } }, "description": "Response shape depends on the selected model and method.", "headers": { "X-Request-ID": { "description": "Preserve the original Request ID.", "schema": { "type": "string" } } } }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Public error classes: invalid_request, context_length_exceeded, content_policy_violation.", "headers": { "Retry-After": { "description": "Wait the returned number of seconds before an allowed retry.", "schema": { "type": "string" } }, "X-Request-ID": { "description": "Preserve the original Request ID.", "schema": { "type": "string" } }, "X-Should-Retry": { "description": "false forbids automatic retry; unknown outcomes must be reconciled.", "schema": { "enum": [ "true", "false" ], "type": "string" } } } }, "401": { "content": { "application/json": { "examples": { "anthropic": { "value": { "error": { "code": "invalid_api_key", "message": "… Nothing was charged. … Request ID: .", "reason": "invalid_api_key", "type": "authentication_error" }, "request_id": "", "type": "error" } }, "gemini": { "value": { "error": { "code": 401, "details": [ { "@type": "type.googleapis.com/google.rpc.ErrorInfo", "domain": "ailoot.ai", "metadata": { "code": "invalid_api_key", "reason": "invalid_api_key", "request_id": "" }, "reason": "INVALID_API_KEY" }, { "@type": "type.googleapis.com/google.rpc.RequestInfo", "requestId": "" } ], "message": "The API key is not valid. Nothing was charged. … Request ID: .", "status": "UNAUTHENTICATED" } } }, "openai": { "value": { "code": "API_KEY_REQUIRED", "error": { "code": "invalid_api_key", "message": "No API key was sent with the request. Nothing was charged. Please check that the full key is sent in the Authorization header as \"Bearer \". Request ID: .", "param": null, "reason": "invalid_api_key", "request_id": "", "type": "invalid_request_error" }, "message": "No API key was sent with the request. Nothing was charged. …" } } }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Public error classes: invalid_api_key, api_key_disabled.", "headers": { "Retry-After": { "description": "Wait the returned number of seconds before an allowed retry.", "schema": { "type": "string" } }, "X-Request-ID": { "description": "Preserve the original Request ID.", "schema": { "type": "string" } }, "X-Should-Retry": { "description": "false forbids automatic retry; unknown outcomes must be reconciled.", "schema": { "enum": [ "true", "false" ], "type": "string" } } } }, "402": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Public error classes: insufficient_balance, insufficient_quota, api_key_quota_exhausted, payment_disputed.", "headers": { "Retry-After": { "description": "Wait the returned number of seconds before an allowed retry.", "schema": { "type": "string" } }, "X-Request-ID": { "description": "Preserve the original Request ID.", "schema": { "type": "string" } }, "X-Should-Retry": { "description": "false forbids automatic retry; unknown outcomes must be reconciled.", "schema": { "enum": [ "true", "false" ], "type": "string" } } } }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Public error classes: api_key_expired, account_inactive, permission_denied.", "headers": { "Retry-After": { "description": "Wait the returned number of seconds before an allowed retry.", "schema": { "type": "string" } }, "X-Request-ID": { "description": "Preserve the original Request ID.", "schema": { "type": "string" } }, "X-Should-Retry": { "description": "false forbids automatic retry; unknown outcomes must be reconciled.", "schema": { "enum": [ "true", "false" ], "type": "string" } } } }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Public error classes: model_not_found, unsupported_endpoint, not_found.", "headers": { "Retry-After": { "description": "Wait the returned number of seconds before an allowed retry.", "schema": { "type": "string" } }, "X-Request-ID": { "description": "Preserve the original Request ID.", "schema": { "type": "string" } }, "X-Should-Retry": { "description": "false forbids automatic retry; unknown outcomes must be reconciled.", "schema": { "enum": [ "true", "false" ], "type": "string" } } } }, "409": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Public error classes: duplicate_request, not_ready, video_not_ready, result_pending_check.", "headers": { "Retry-After": { "description": "Wait the returned number of seconds before an allowed retry.", "schema": { "type": "string" } }, "X-Request-ID": { "description": "Preserve the original Request ID.", "schema": { "type": "string" } }, "X-Should-Retry": { "description": "false forbids automatic retry; unknown outcomes must be reconciled.", "schema": { "enum": [ "true", "false" ], "type": "string" } } } }, "410": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Public error classes: model_retired.", "headers": { "Retry-After": { "description": "Wait the returned number of seconds before an allowed retry.", "schema": { "type": "string" } }, "X-Request-ID": { "description": "Preserve the original Request ID.", "schema": { "type": "string" } }, "X-Should-Retry": { "description": "false forbids automatic retry; unknown outcomes must be reconciled.", "schema": { "enum": [ "true", "false" ], "type": "string" } } } }, "413": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Public error classes: request_too_large.", "headers": { "Retry-After": { "description": "Wait the returned number of seconds before an allowed retry.", "schema": { "type": "string" } }, "X-Request-ID": { "description": "Preserve the original Request ID.", "schema": { "type": "string" } }, "X-Should-Retry": { "description": "false forbids automatic retry; unknown outcomes must be reconciled.", "schema": { "enum": [ "true", "false" ], "type": "string" } } } }, "429": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Public error classes: rate_limit_exceeded, gateway_concurrency_limit, gateway_queue_full, usage_limit_reached.", "headers": { "Retry-After": { "description": "Wait the returned number of seconds before an allowed retry.", "schema": { "type": "string" } }, "X-Request-ID": { "description": "Preserve the original Request ID.", "schema": { "type": "string" } }, "X-Should-Retry": { "description": "false forbids automatic retry; unknown outcomes must be reconciled.", "schema": { "enum": [ "true", "false" ], "type": "string" } } } }, "4XX": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Response shape depends on the selected model and method.", "headers": { "X-Request-ID": { "description": "Preserve the original Request ID.", "schema": { "type": "string" } } } }, "500": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Public error classes: internal_error.", "headers": { "Retry-After": { "description": "Wait the returned number of seconds before an allowed retry.", "schema": { "type": "string" } }, "X-Request-ID": { "description": "Preserve the original Request ID.", "schema": { "type": "string" } }, "X-Should-Retry": { "description": "false forbids automatic retry; unknown outcomes must be reconciled.", "schema": { "enum": [ "true", "false" ], "type": "string" } } } }, "502": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Public error classes: invalid_model_response, empty_response, incomplete_response, result_not_delivered.", "headers": { "Retry-After": { "description": "Wait the returned number of seconds before an allowed retry.", "schema": { "type": "string" } }, "X-Request-ID": { "description": "Preserve the original Request ID.", "schema": { "type": "string" } }, "X-Should-Retry": { "description": "false forbids automatic retry; unknown outcomes must be reconciled.", "schema": { "enum": [ "true", "false" ], "type": "string" } } } }, "503": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Public error classes: model_overloaded, model_unavailable, service_unavailable, charge_not_confirmed, result_pending_check.", "headers": { "Retry-After": { "description": "Wait the returned number of seconds before an allowed retry.", "schema": { "type": "string" } }, "X-Request-ID": { "description": "Preserve the original Request ID.", "schema": { "type": "string" } }, "X-Should-Retry": { "description": "false forbids automatic retry; unknown outcomes must be reconciled.", "schema": { "enum": [ "true", "false" ], "type": "string" } } } }, "504": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Public error classes: model_timeout.", "headers": { "Retry-After": { "description": "Wait the returned number of seconds before an allowed retry.", "schema": { "type": "string" } }, "X-Request-ID": { "description": "Preserve the original Request ID.", "schema": { "type": "string" } }, "X-Should-Retry": { "description": "false forbids automatic retry; unknown outcomes must be reconciled.", "schema": { "enum": [ "true", "false" ], "type": "string" } } } }, "5XX": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Response shape depends on the selected model and method.", "headers": { "X-Request-ID": { "description": "Preserve the original Request ID.", "schema": { "type": "string" } } } } }, "security": [ { "clientBearer": [] } ], "summary": "Create a message" } }, "/v1/messages/count_tokens": { "post": { "description": "Documented token-counting path; unavailable for models in the current public catalogue.", "operationId": "countMessageTokens", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CountTokensRequest" } } }, "required": true }, "responses": { "200": { "content": { "application/json": { "schema": { "additionalProperties": true, "properties": { "input_tokens": { "type": "integer" } }, "type": "object" } } }, "description": "Response shape depends on the selected model and method.", "headers": { "X-Request-ID": { "description": "Preserve the original Request ID.", "schema": { "type": "string" } } } }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Public error classes: invalid_request, context_length_exceeded, content_policy_violation.", "headers": { "Retry-After": { "description": "Wait the returned number of seconds before an allowed retry.", "schema": { "type": "string" } }, "X-Request-ID": { "description": "Preserve the original Request ID.", "schema": { "type": "string" } }, "X-Should-Retry": { "description": "false forbids automatic retry; unknown outcomes must be reconciled.", "schema": { "enum": [ "true", "false" ], "type": "string" } } } }, "401": { "content": { "application/json": { "examples": { "anthropic": { "value": { "error": { "code": "invalid_api_key", "message": "… Nothing was charged. … Request ID: .", "reason": "invalid_api_key", "type": "authentication_error" }, "request_id": "", "type": "error" } }, "gemini": { "value": { "error": { "code": 401, "details": [ { "@type": "type.googleapis.com/google.rpc.ErrorInfo", "domain": "ailoot.ai", "metadata": { "code": "invalid_api_key", "reason": "invalid_api_key", "request_id": "" }, "reason": "INVALID_API_KEY" }, { "@type": "type.googleapis.com/google.rpc.RequestInfo", "requestId": "" } ], "message": "The API key is not valid. Nothing was charged. … Request ID: .", "status": "UNAUTHENTICATED" } } }, "openai": { "value": { "code": "API_KEY_REQUIRED", "error": { "code": "invalid_api_key", "message": "No API key was sent with the request. Nothing was charged. Please check that the full key is sent in the Authorization header as \"Bearer \". Request ID: .", "param": null, "reason": "invalid_api_key", "request_id": "", "type": "invalid_request_error" }, "message": "No API key was sent with the request. Nothing was charged. …" } } }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Public error classes: invalid_api_key, api_key_disabled.", "headers": { "Retry-After": { "description": "Wait the returned number of seconds before an allowed retry.", "schema": { "type": "string" } }, "X-Request-ID": { "description": "Preserve the original Request ID.", "schema": { "type": "string" } }, "X-Should-Retry": { "description": "false forbids automatic retry; unknown outcomes must be reconciled.", "schema": { "enum": [ "true", "false" ], "type": "string" } } } }, "402": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Public error classes: insufficient_balance, insufficient_quota, api_key_quota_exhausted, payment_disputed.", "headers": { "Retry-After": { "description": "Wait the returned number of seconds before an allowed retry.", "schema": { "type": "string" } }, "X-Request-ID": { "description": "Preserve the original Request ID.", "schema": { "type": "string" } }, "X-Should-Retry": { "description": "false forbids automatic retry; unknown outcomes must be reconciled.", "schema": { "enum": [ "true", "false" ], "type": "string" } } } }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Public error classes: api_key_expired, account_inactive, permission_denied.", "headers": { "Retry-After": { "description": "Wait the returned number of seconds before an allowed retry.", "schema": { "type": "string" } }, "X-Request-ID": { "description": "Preserve the original Request ID.", "schema": { "type": "string" } }, "X-Should-Retry": { "description": "false forbids automatic retry; unknown outcomes must be reconciled.", "schema": { "enum": [ "true", "false" ], "type": "string" } } } }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Public error classes: model_not_found, unsupported_endpoint, not_found.", "headers": { "Retry-After": { "description": "Wait the returned number of seconds before an allowed retry.", "schema": { "type": "string" } }, "X-Request-ID": { "description": "Preserve the original Request ID.", "schema": { "type": "string" } }, "X-Should-Retry": { "description": "false forbids automatic retry; unknown outcomes must be reconciled.", "schema": { "enum": [ "true", "false" ], "type": "string" } } } }, "409": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Public error classes: duplicate_request, not_ready, video_not_ready, result_pending_check.", "headers": { "Retry-After": { "description": "Wait the returned number of seconds before an allowed retry.", "schema": { "type": "string" } }, "X-Request-ID": { "description": "Preserve the original Request ID.", "schema": { "type": "string" } }, "X-Should-Retry": { "description": "false forbids automatic retry; unknown outcomes must be reconciled.", "schema": { "enum": [ "true", "false" ], "type": "string" } } } }, "410": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Public error classes: model_retired.", "headers": { "Retry-After": { "description": "Wait the returned number of seconds before an allowed retry.", "schema": { "type": "string" } }, "X-Request-ID": { "description": "Preserve the original Request ID.", "schema": { "type": "string" } }, "X-Should-Retry": { "description": "false forbids automatic retry; unknown outcomes must be reconciled.", "schema": { "enum": [ "true", "false" ], "type": "string" } } } }, "413": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Public error classes: request_too_large.", "headers": { "Retry-After": { "description": "Wait the returned number of seconds before an allowed retry.", "schema": { "type": "string" } }, "X-Request-ID": { "description": "Preserve the original Request ID.", "schema": { "type": "string" } }, "X-Should-Retry": { "description": "false forbids automatic retry; unknown outcomes must be reconciled.", "schema": { "enum": [ "true", "false" ], "type": "string" } } } }, "429": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Public error classes: rate_limit_exceeded, gateway_concurrency_limit, gateway_queue_full, usage_limit_reached.", "headers": { "Retry-After": { "description": "Wait the returned number of seconds before an allowed retry.", "schema": { "type": "string" } }, "X-Request-ID": { "description": "Preserve the original Request ID.", "schema": { "type": "string" } }, "X-Should-Retry": { "description": "false forbids automatic retry; unknown outcomes must be reconciled.", "schema": { "enum": [ "true", "false" ], "type": "string" } } } }, "4XX": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Response shape depends on the selected model and method.", "headers": { "X-Request-ID": { "description": "Preserve the original Request ID.", "schema": { "type": "string" } } } }, "500": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Public error classes: internal_error.", "headers": { "Retry-After": { "description": "Wait the returned number of seconds before an allowed retry.", "schema": { "type": "string" } }, "X-Request-ID": { "description": "Preserve the original Request ID.", "schema": { "type": "string" } }, "X-Should-Retry": { "description": "false forbids automatic retry; unknown outcomes must be reconciled.", "schema": { "enum": [ "true", "false" ], "type": "string" } } } }, "502": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Public error classes: invalid_model_response, empty_response, incomplete_response, result_not_delivered.", "headers": { "Retry-After": { "description": "Wait the returned number of seconds before an allowed retry.", "schema": { "type": "string" } }, "X-Request-ID": { "description": "Preserve the original Request ID.", "schema": { "type": "string" } }, "X-Should-Retry": { "description": "false forbids automatic retry; unknown outcomes must be reconciled.", "schema": { "enum": [ "true", "false" ], "type": "string" } } } }, "503": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Public error classes: model_overloaded, model_unavailable, service_unavailable, charge_not_confirmed, result_pending_check.", "headers": { "Retry-After": { "description": "Wait the returned number of seconds before an allowed retry.", "schema": { "type": "string" } }, "X-Request-ID": { "description": "Preserve the original Request ID.", "schema": { "type": "string" } }, "X-Should-Retry": { "description": "false forbids automatic retry; unknown outcomes must be reconciled.", "schema": { "enum": [ "true", "false" ], "type": "string" } } } }, "504": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Public error classes: model_timeout.", "headers": { "Retry-After": { "description": "Wait the returned number of seconds before an allowed retry.", "schema": { "type": "string" } }, "X-Request-ID": { "description": "Preserve the original Request ID.", "schema": { "type": "string" } }, "X-Should-Retry": { "description": "false forbids automatic retry; unknown outcomes must be reconciled.", "schema": { "enum": [ "true", "false" ], "type": "string" } } } }, "5XX": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Response shape depends on the selected model and method.", "headers": { "X-Request-ID": { "description": "Preserve the original Request ID.", "schema": { "type": "string" } } } } }, "security": [ { "clientBearer": [] } ], "summary": "Count message input tokens" } }, "/v1/models": { "get": { "operationId": "listModels", "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Models" } } }, "description": "Response shape depends on the selected model and method.", "headers": { "X-Request-ID": { "description": "Preserve the original Request ID.", "schema": { "type": "string" } } } }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Public error classes: invalid_request, context_length_exceeded, content_policy_violation.", "headers": { "Retry-After": { "description": "Wait the returned number of seconds before an allowed retry.", "schema": { "type": "string" } }, "X-Request-ID": { "description": "Preserve the original Request ID.", "schema": { "type": "string" } }, "X-Should-Retry": { "description": "false forbids automatic retry; unknown outcomes must be reconciled.", "schema": { "enum": [ "true", "false" ], "type": "string" } } } }, "401": { "content": { "application/json": { "examples": { "anthropic": { "value": { "error": { "code": "invalid_api_key", "message": "… Nothing was charged. … Request ID: .", "reason": "invalid_api_key", "type": "authentication_error" }, "request_id": "", "type": "error" } }, "gemini": { "value": { "error": { "code": 401, "details": [ { "@type": "type.googleapis.com/google.rpc.ErrorInfo", "domain": "ailoot.ai", "metadata": { "code": "invalid_api_key", "reason": "invalid_api_key", "request_id": "" }, "reason": "INVALID_API_KEY" }, { "@type": "type.googleapis.com/google.rpc.RequestInfo", "requestId": "" } ], "message": "The API key is not valid. Nothing was charged. … Request ID: .", "status": "UNAUTHENTICATED" } } }, "openai": { "value": { "code": "API_KEY_REQUIRED", "error": { "code": "invalid_api_key", "message": "No API key was sent with the request. Nothing was charged. Please check that the full key is sent in the Authorization header as \"Bearer \". Request ID: .", "param": null, "reason": "invalid_api_key", "request_id": "", "type": "invalid_request_error" }, "message": "No API key was sent with the request. Nothing was charged. …" } } }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Public error classes: invalid_api_key, api_key_disabled.", "headers": { "Retry-After": { "description": "Wait the returned number of seconds before an allowed retry.", "schema": { "type": "string" } }, "X-Request-ID": { "description": "Preserve the original Request ID.", "schema": { "type": "string" } }, "X-Should-Retry": { "description": "false forbids automatic retry; unknown outcomes must be reconciled.", "schema": { "enum": [ "true", "false" ], "type": "string" } } } }, "402": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Public error classes: insufficient_balance, insufficient_quota, api_key_quota_exhausted, payment_disputed.", "headers": { "Retry-After": { "description": "Wait the returned number of seconds before an allowed retry.", "schema": { "type": "string" } }, "X-Request-ID": { "description": "Preserve the original Request ID.", "schema": { "type": "string" } }, "X-Should-Retry": { "description": "false forbids automatic retry; unknown outcomes must be reconciled.", "schema": { "enum": [ "true", "false" ], "type": "string" } } } }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Public error classes: api_key_expired, account_inactive, permission_denied.", "headers": { "Retry-After": { "description": "Wait the returned number of seconds before an allowed retry.", "schema": { "type": "string" } }, "X-Request-ID": { "description": "Preserve the original Request ID.", "schema": { "type": "string" } }, "X-Should-Retry": { "description": "false forbids automatic retry; unknown outcomes must be reconciled.", "schema": { "enum": [ "true", "false" ], "type": "string" } } } }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Public error classes: model_not_found, unsupported_endpoint, not_found.", "headers": { "Retry-After": { "description": "Wait the returned number of seconds before an allowed retry.", "schema": { "type": "string" } }, "X-Request-ID": { "description": "Preserve the original Request ID.", "schema": { "type": "string" } }, "X-Should-Retry": { "description": "false forbids automatic retry; unknown outcomes must be reconciled.", "schema": { "enum": [ "true", "false" ], "type": "string" } } } }, "409": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Public error classes: duplicate_request, not_ready, video_not_ready, result_pending_check.", "headers": { "Retry-After": { "description": "Wait the returned number of seconds before an allowed retry.", "schema": { "type": "string" } }, "X-Request-ID": { "description": "Preserve the original Request ID.", "schema": { "type": "string" } }, "X-Should-Retry": { "description": "false forbids automatic retry; unknown outcomes must be reconciled.", "schema": { "enum": [ "true", "false" ], "type": "string" } } } }, "410": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Public error classes: model_retired.", "headers": { "Retry-After": { "description": "Wait the returned number of seconds before an allowed retry.", "schema": { "type": "string" } }, "X-Request-ID": { "description": "Preserve the original Request ID.", "schema": { "type": "string" } }, "X-Should-Retry": { "description": "false forbids automatic retry; unknown outcomes must be reconciled.", "schema": { "enum": [ "true", "false" ], "type": "string" } } } }, "413": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Public error classes: request_too_large.", "headers": { "Retry-After": { "description": "Wait the returned number of seconds before an allowed retry.", "schema": { "type": "string" } }, "X-Request-ID": { "description": "Preserve the original Request ID.", "schema": { "type": "string" } }, "X-Should-Retry": { "description": "false forbids automatic retry; unknown outcomes must be reconciled.", "schema": { "enum": [ "true", "false" ], "type": "string" } } } }, "429": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Public error classes: rate_limit_exceeded, gateway_concurrency_limit, gateway_queue_full, usage_limit_reached.", "headers": { "Retry-After": { "description": "Wait the returned number of seconds before an allowed retry.", "schema": { "type": "string" } }, "X-Request-ID": { "description": "Preserve the original Request ID.", "schema": { "type": "string" } }, "X-Should-Retry": { "description": "false forbids automatic retry; unknown outcomes must be reconciled.", "schema": { "enum": [ "true", "false" ], "type": "string" } } } }, "4XX": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Response shape depends on the selected model and method.", "headers": { "X-Request-ID": { "description": "Preserve the original Request ID.", "schema": { "type": "string" } } } }, "500": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Public error classes: internal_error.", "headers": { "Retry-After": { "description": "Wait the returned number of seconds before an allowed retry.", "schema": { "type": "string" } }, "X-Request-ID": { "description": "Preserve the original Request ID.", "schema": { "type": "string" } }, "X-Should-Retry": { "description": "false forbids automatic retry; unknown outcomes must be reconciled.", "schema": { "enum": [ "true", "false" ], "type": "string" } } } }, "502": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Public error classes: invalid_model_response, empty_response, incomplete_response, result_not_delivered.", "headers": { "Retry-After": { "description": "Wait the returned number of seconds before an allowed retry.", "schema": { "type": "string" } }, "X-Request-ID": { "description": "Preserve the original Request ID.", "schema": { "type": "string" } }, "X-Should-Retry": { "description": "false forbids automatic retry; unknown outcomes must be reconciled.", "schema": { "enum": [ "true", "false" ], "type": "string" } } } }, "503": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Public error classes: model_overloaded, model_unavailable, service_unavailable, charge_not_confirmed, result_pending_check.", "headers": { "Retry-After": { "description": "Wait the returned number of seconds before an allowed retry.", "schema": { "type": "string" } }, "X-Request-ID": { "description": "Preserve the original Request ID.", "schema": { "type": "string" } }, "X-Should-Retry": { "description": "false forbids automatic retry; unknown outcomes must be reconciled.", "schema": { "enum": [ "true", "false" ], "type": "string" } } } }, "504": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Public error classes: model_timeout.", "headers": { "Retry-After": { "description": "Wait the returned number of seconds before an allowed retry.", "schema": { "type": "string" } }, "X-Request-ID": { "description": "Preserve the original Request ID.", "schema": { "type": "string" } }, "X-Should-Retry": { "description": "false forbids automatic retry; unknown outcomes must be reconciled.", "schema": { "enum": [ "true", "false" ], "type": "string" } } } }, "5XX": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Response shape depends on the selected model and method.", "headers": { "X-Request-ID": { "description": "Preserve the original Request ID.", "schema": { "type": "string" } } } } }, "security": [ { "clientBearer": [] } ], "summary": "List models visible to the client key" } }, "/v1/music/generations": { "post": { "operationId": "createMusic", "requestBody": { "content": { "application/json": { "example": { "model": "google/lyria", "prompt": "Calm piano and cello, no vocals" }, "schema": { "$ref": "#/components/schemas/MusicRequest" } } }, "required": true }, "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MusicResponse" } } }, "description": "Completed documented response.", "headers": { "X-Request-ID": { "description": "Preserve the original Request ID.", "schema": { "type": "string" } } } }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Public error classes: invalid_request, context_length_exceeded, content_policy_violation.", "headers": { "Retry-After": { "description": "Wait the returned number of seconds before an allowed retry.", "schema": { "type": "string" } }, "X-Request-ID": { "description": "Preserve the original Request ID.", "schema": { "type": "string" } }, "X-Should-Retry": { "description": "false forbids automatic retry; unknown outcomes must be reconciled.", "schema": { "enum": [ "true", "false" ], "type": "string" } } } }, "401": { "content": { "application/json": { "examples": { "anthropic": { "value": { "error": { "code": "invalid_api_key", "message": "… Nothing was charged. … Request ID: .", "reason": "invalid_api_key", "type": "authentication_error" }, "request_id": "", "type": "error" } }, "gemini": { "value": { "error": { "code": 401, "details": [ { "@type": "type.googleapis.com/google.rpc.ErrorInfo", "domain": "ailoot.ai", "metadata": { "code": "invalid_api_key", "reason": "invalid_api_key", "request_id": "" }, "reason": "INVALID_API_KEY" }, { "@type": "type.googleapis.com/google.rpc.RequestInfo", "requestId": "" } ], "message": "The API key is not valid. Nothing was charged. … Request ID: .", "status": "UNAUTHENTICATED" } } }, "openai": { "value": { "code": "API_KEY_REQUIRED", "error": { "code": "invalid_api_key", "message": "No API key was sent with the request. Nothing was charged. Please check that the full key is sent in the Authorization header as \"Bearer \". Request ID: .", "param": null, "reason": "invalid_api_key", "request_id": "", "type": "invalid_request_error" }, "message": "No API key was sent with the request. Nothing was charged. …" } } }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Public error classes: invalid_api_key, api_key_disabled.", "headers": { "Retry-After": { "description": "Wait the returned number of seconds before an allowed retry.", "schema": { "type": "string" } }, "X-Request-ID": { "description": "Preserve the original Request ID.", "schema": { "type": "string" } }, "X-Should-Retry": { "description": "false forbids automatic retry; unknown outcomes must be reconciled.", "schema": { "enum": [ "true", "false" ], "type": "string" } } } }, "402": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Public error classes: insufficient_balance, insufficient_quota, api_key_quota_exhausted, payment_disputed.", "headers": { "Retry-After": { "description": "Wait the returned number of seconds before an allowed retry.", "schema": { "type": "string" } }, "X-Request-ID": { "description": "Preserve the original Request ID.", "schema": { "type": "string" } }, "X-Should-Retry": { "description": "false forbids automatic retry; unknown outcomes must be reconciled.", "schema": { "enum": [ "true", "false" ], "type": "string" } } } }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Public error classes: api_key_expired, account_inactive, permission_denied.", "headers": { "Retry-After": { "description": "Wait the returned number of seconds before an allowed retry.", "schema": { "type": "string" } }, "X-Request-ID": { "description": "Preserve the original Request ID.", "schema": { "type": "string" } }, "X-Should-Retry": { "description": "false forbids automatic retry; unknown outcomes must be reconciled.", "schema": { "enum": [ "true", "false" ], "type": "string" } } } }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Public error classes: model_not_found, unsupported_endpoint, not_found.", "headers": { "Retry-After": { "description": "Wait the returned number of seconds before an allowed retry.", "schema": { "type": "string" } }, "X-Request-ID": { "description": "Preserve the original Request ID.", "schema": { "type": "string" } }, "X-Should-Retry": { "description": "false forbids automatic retry; unknown outcomes must be reconciled.", "schema": { "enum": [ "true", "false" ], "type": "string" } } } }, "409": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Public error classes: duplicate_request, not_ready, video_not_ready, result_pending_check.", "headers": { "Retry-After": { "description": "Wait the returned number of seconds before an allowed retry.", "schema": { "type": "string" } }, "X-Request-ID": { "description": "Preserve the original Request ID.", "schema": { "type": "string" } }, "X-Should-Retry": { "description": "false forbids automatic retry; unknown outcomes must be reconciled.", "schema": { "enum": [ "true", "false" ], "type": "string" } } } }, "410": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Public error classes: model_retired.", "headers": { "Retry-After": { "description": "Wait the returned number of seconds before an allowed retry.", "schema": { "type": "string" } }, "X-Request-ID": { "description": "Preserve the original Request ID.", "schema": { "type": "string" } }, "X-Should-Retry": { "description": "false forbids automatic retry; unknown outcomes must be reconciled.", "schema": { "enum": [ "true", "false" ], "type": "string" } } } }, "413": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Public error classes: request_too_large.", "headers": { "Retry-After": { "description": "Wait the returned number of seconds before an allowed retry.", "schema": { "type": "string" } }, "X-Request-ID": { "description": "Preserve the original Request ID.", "schema": { "type": "string" } }, "X-Should-Retry": { "description": "false forbids automatic retry; unknown outcomes must be reconciled.", "schema": { "enum": [ "true", "false" ], "type": "string" } } } }, "429": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Public error classes: rate_limit_exceeded, gateway_concurrency_limit, gateway_queue_full, usage_limit_reached.", "headers": { "Retry-After": { "description": "Wait the returned number of seconds before an allowed retry.", "schema": { "type": "string" } }, "X-Request-ID": { "description": "Preserve the original Request ID.", "schema": { "type": "string" } }, "X-Should-Retry": { "description": "false forbids automatic retry; unknown outcomes must be reconciled.", "schema": { "enum": [ "true", "false" ], "type": "string" } } } }, "500": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Public error classes: internal_error.", "headers": { "Retry-After": { "description": "Wait the returned number of seconds before an allowed retry.", "schema": { "type": "string" } }, "X-Request-ID": { "description": "Preserve the original Request ID.", "schema": { "type": "string" } }, "X-Should-Retry": { "description": "false forbids automatic retry; unknown outcomes must be reconciled.", "schema": { "enum": [ "true", "false" ], "type": "string" } } } }, "502": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Public error classes: invalid_model_response, empty_response, incomplete_response, result_not_delivered.", "headers": { "Retry-After": { "description": "Wait the returned number of seconds before an allowed retry.", "schema": { "type": "string" } }, "X-Request-ID": { "description": "Preserve the original Request ID.", "schema": { "type": "string" } }, "X-Should-Retry": { "description": "false forbids automatic retry; unknown outcomes must be reconciled.", "schema": { "enum": [ "true", "false" ], "type": "string" } } } }, "503": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Public error classes: model_overloaded, model_unavailable, service_unavailable, charge_not_confirmed, result_pending_check.", "headers": { "Retry-After": { "description": "Wait the returned number of seconds before an allowed retry.", "schema": { "type": "string" } }, "X-Request-ID": { "description": "Preserve the original Request ID.", "schema": { "type": "string" } }, "X-Should-Retry": { "description": "false forbids automatic retry; unknown outcomes must be reconciled.", "schema": { "enum": [ "true", "false" ], "type": "string" } } } }, "504": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Public error classes: model_timeout.", "headers": { "Retry-After": { "description": "Wait the returned number of seconds before an allowed retry.", "schema": { "type": "string" } }, "X-Request-ID": { "description": "Preserve the original Request ID.", "schema": { "type": "string" } }, "X-Should-Retry": { "description": "false forbids automatic retry; unknown outcomes must be reconciled.", "schema": { "enum": [ "true", "false" ], "type": "string" } } } } }, "security": [ { "clientBearer": [] } ], "summary": "Create music clips" } }, "/v1/realtime": { "get": { "operationId": "openRealtimeSession", "parameters": [ { "in": "query", "name": "model", "required": true, "schema": { "enum": [ "qwen-audio-3.0-realtime-plus" ], "type": "string" } } ], "responses": { "101": { "description": "WebSocket handshake; authenticate using the client Bearer header.", "headers": { "X-Request-ID": { "description": "Preserve the original Request ID.", "schema": { "type": "string" } } } }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Public error classes: invalid_request, context_length_exceeded, content_policy_violation.", "headers": { "Retry-After": { "description": "Wait the returned number of seconds before an allowed retry.", "schema": { "type": "string" } }, "X-Request-ID": { "description": "Preserve the original Request ID.", "schema": { "type": "string" } }, "X-Should-Retry": { "description": "false forbids automatic retry; unknown outcomes must be reconciled.", "schema": { "enum": [ "true", "false" ], "type": "string" } } } }, "401": { "content": { "application/json": { "examples": { "anthropic": { "value": { "error": { "code": "invalid_api_key", "message": "… Nothing was charged. … Request ID: .", "reason": "invalid_api_key", "type": "authentication_error" }, "request_id": "", "type": "error" } }, "gemini": { "value": { "error": { "code": 401, "details": [ { "@type": "type.googleapis.com/google.rpc.ErrorInfo", "domain": "ailoot.ai", "metadata": { "code": "invalid_api_key", "reason": "invalid_api_key", "request_id": "" }, "reason": "INVALID_API_KEY" }, { "@type": "type.googleapis.com/google.rpc.RequestInfo", "requestId": "" } ], "message": "The API key is not valid. Nothing was charged. … Request ID: .", "status": "UNAUTHENTICATED" } } }, "openai": { "value": { "code": "API_KEY_REQUIRED", "error": { "code": "invalid_api_key", "message": "No API key was sent with the request. Nothing was charged. Please check that the full key is sent in the Authorization header as \"Bearer \". Request ID: .", "param": null, "reason": "invalid_api_key", "request_id": "", "type": "invalid_request_error" }, "message": "No API key was sent with the request. Nothing was charged. …" } } }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Public error classes: invalid_api_key, api_key_disabled.", "headers": { "Retry-After": { "description": "Wait the returned number of seconds before an allowed retry.", "schema": { "type": "string" } }, "X-Request-ID": { "description": "Preserve the original Request ID.", "schema": { "type": "string" } }, "X-Should-Retry": { "description": "false forbids automatic retry; unknown outcomes must be reconciled.", "schema": { "enum": [ "true", "false" ], "type": "string" } } } }, "402": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Public error classes: insufficient_balance, insufficient_quota, api_key_quota_exhausted, payment_disputed.", "headers": { "Retry-After": { "description": "Wait the returned number of seconds before an allowed retry.", "schema": { "type": "string" } }, "X-Request-ID": { "description": "Preserve the original Request ID.", "schema": { "type": "string" } }, "X-Should-Retry": { "description": "false forbids automatic retry; unknown outcomes must be reconciled.", "schema": { "enum": [ "true", "false" ], "type": "string" } } } }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Public error classes: api_key_expired, account_inactive, permission_denied.", "headers": { "Retry-After": { "description": "Wait the returned number of seconds before an allowed retry.", "schema": { "type": "string" } }, "X-Request-ID": { "description": "Preserve the original Request ID.", "schema": { "type": "string" } }, "X-Should-Retry": { "description": "false forbids automatic retry; unknown outcomes must be reconciled.", "schema": { "enum": [ "true", "false" ], "type": "string" } } } }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Public error classes: model_not_found, unsupported_endpoint, not_found.", "headers": { "Retry-After": { "description": "Wait the returned number of seconds before an allowed retry.", "schema": { "type": "string" } }, "X-Request-ID": { "description": "Preserve the original Request ID.", "schema": { "type": "string" } }, "X-Should-Retry": { "description": "false forbids automatic retry; unknown outcomes must be reconciled.", "schema": { "enum": [ "true", "false" ], "type": "string" } } } }, "409": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Public error classes: duplicate_request, not_ready, video_not_ready, result_pending_check.", "headers": { "Retry-After": { "description": "Wait the returned number of seconds before an allowed retry.", "schema": { "type": "string" } }, "X-Request-ID": { "description": "Preserve the original Request ID.", "schema": { "type": "string" } }, "X-Should-Retry": { "description": "false forbids automatic retry; unknown outcomes must be reconciled.", "schema": { "enum": [ "true", "false" ], "type": "string" } } } }, "410": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Public error classes: model_retired.", "headers": { "Retry-After": { "description": "Wait the returned number of seconds before an allowed retry.", "schema": { "type": "string" } }, "X-Request-ID": { "description": "Preserve the original Request ID.", "schema": { "type": "string" } }, "X-Should-Retry": { "description": "false forbids automatic retry; unknown outcomes must be reconciled.", "schema": { "enum": [ "true", "false" ], "type": "string" } } } }, "413": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Public error classes: request_too_large.", "headers": { "Retry-After": { "description": "Wait the returned number of seconds before an allowed retry.", "schema": { "type": "string" } }, "X-Request-ID": { "description": "Preserve the original Request ID.", "schema": { "type": "string" } }, "X-Should-Retry": { "description": "false forbids automatic retry; unknown outcomes must be reconciled.", "schema": { "enum": [ "true", "false" ], "type": "string" } } } }, "429": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Public error classes: rate_limit_exceeded, gateway_concurrency_limit, gateway_queue_full, usage_limit_reached.", "headers": { "Retry-After": { "description": "Wait the returned number of seconds before an allowed retry.", "schema": { "type": "string" } }, "X-Request-ID": { "description": "Preserve the original Request ID.", "schema": { "type": "string" } }, "X-Should-Retry": { "description": "false forbids automatic retry; unknown outcomes must be reconciled.", "schema": { "enum": [ "true", "false" ], "type": "string" } } } }, "500": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Public error classes: internal_error.", "headers": { "Retry-After": { "description": "Wait the returned number of seconds before an allowed retry.", "schema": { "type": "string" } }, "X-Request-ID": { "description": "Preserve the original Request ID.", "schema": { "type": "string" } }, "X-Should-Retry": { "description": "false forbids automatic retry; unknown outcomes must be reconciled.", "schema": { "enum": [ "true", "false" ], "type": "string" } } } }, "502": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Public error classes: invalid_model_response, empty_response, incomplete_response, result_not_delivered.", "headers": { "Retry-After": { "description": "Wait the returned number of seconds before an allowed retry.", "schema": { "type": "string" } }, "X-Request-ID": { "description": "Preserve the original Request ID.", "schema": { "type": "string" } }, "X-Should-Retry": { "description": "false forbids automatic retry; unknown outcomes must be reconciled.", "schema": { "enum": [ "true", "false" ], "type": "string" } } } }, "503": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Public error classes: model_overloaded, model_unavailable, service_unavailable, charge_not_confirmed, result_pending_check.", "headers": { "Retry-After": { "description": "Wait the returned number of seconds before an allowed retry.", "schema": { "type": "string" } }, "X-Request-ID": { "description": "Preserve the original Request ID.", "schema": { "type": "string" } }, "X-Should-Retry": { "description": "false forbids automatic retry; unknown outcomes must be reconciled.", "schema": { "enum": [ "true", "false" ], "type": "string" } } } }, "504": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Public error classes: model_timeout.", "headers": { "Retry-After": { "description": "Wait the returned number of seconds before an allowed retry.", "schema": { "type": "string" } }, "X-Request-ID": { "description": "Preserve the original Request ID.", "schema": { "type": "string" } }, "X-Should-Retry": { "description": "false forbids automatic retry; unknown outcomes must be reconciled.", "schema": { "enum": [ "true", "false" ], "type": "string" } } } } }, "security": [ { "clientBearer": [] } ], "summary": "Open the documented realtime voice WebSocket", "x-websocket-events": { "audio_input": { "channels": 1, "encoding": "base64 PCM16", "sample_rate": 16000 }, "audio_output": { "channels": 1, "encoding": "PCM16", "sample_rate": 24000 }, "client": [ "session.update", "input_audio_buffer.append", "input_audio_buffer.commit", "input_audio_buffer.clear", "response.create", "response.cancel", "conversation.item.create", "conversation.item.retrieve", "conversation.item.delete" ], "examples": [ { "session": { "instructions": "Be brief.", "max_history_turns": 20, "modalities": [ "text" ], "turn_detection": null }, "type": "session.update" }, { "item": { "content": [ { "text": "Say yes.", "type": "input_text" } ], "role": "user", "type": "message" }, "type": "conversation.item.create" }, { "type": "response.create" } ], "limits": { "client_text_bytes": 8000, "configured_default_idle_seconds": 60, "history_turns": 20, "instruction_bytes": 2000, "responses": 20, "session_seconds": 600 }, "message_schema": { "additionalProperties": true, "properties": { "type": { "type": "string" } }, "required": [ "type" ], "type": "object" }, "server": [ "session.created", "response.done", "error" ] }, "x-websocket-url": "wss://api.ailoot.ai/v1/realtime?model=qwen-audio-3.0-realtime-plus" } }, "/v1/responses": { "post": { "operationId": "createResponse", "requestBody": { "content": { "application/json": { "example": { "input": "What is 17 + 25? Answer with the number only.", "model": "claude" }, "schema": { "$ref": "#/components/schemas/ResponsesRequest" } } }, "required": true }, "responses": { "200": { "content": { "application/json": { "example": { "id": "", "model": "gpt-6.1-sol", "object": "response", "output": [ { "content": [ { "text": "TCP guarantees delivery and ordering; UDP does not, but is faster…", "type": "output_text" } ], "role": "assistant", "type": "message" } ], "status": "completed", "usage": { "input_tokens": 24, "output_tokens": 61, "total_tokens": 85 } }, "schema": { "$ref": "#/components/schemas/ResponsesResponse" } }, "text/event-stream": { "schema": { "description": "SSE frames use the selected protocol; completion and usage must be processed. A 200 response alone is not completion.", "type": "string" } } }, "description": "Response shape depends on the selected model and method.", "headers": { "X-Request-ID": { "description": "Preserve the original Request ID.", "schema": { "type": "string" } } } }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Public error classes: invalid_request, context_length_exceeded, content_policy_violation.", "headers": { "Retry-After": { "description": "Wait the returned number of seconds before an allowed retry.", "schema": { "type": "string" } }, "X-Request-ID": { "description": "Preserve the original Request ID.", "schema": { "type": "string" } }, "X-Should-Retry": { "description": "false forbids automatic retry; unknown outcomes must be reconciled.", "schema": { "enum": [ "true", "false" ], "type": "string" } } } }, "401": { "content": { "application/json": { "examples": { "anthropic": { "value": { "error": { "code": "invalid_api_key", "message": "… Nothing was charged. … Request ID: .", "reason": "invalid_api_key", "type": "authentication_error" }, "request_id": "", "type": "error" } }, "gemini": { "value": { "error": { "code": 401, "details": [ { "@type": "type.googleapis.com/google.rpc.ErrorInfo", "domain": "ailoot.ai", "metadata": { "code": "invalid_api_key", "reason": "invalid_api_key", "request_id": "" }, "reason": "INVALID_API_KEY" }, { "@type": "type.googleapis.com/google.rpc.RequestInfo", "requestId": "" } ], "message": "The API key is not valid. Nothing was charged. … Request ID: .", "status": "UNAUTHENTICATED" } } }, "openai": { "value": { "code": "API_KEY_REQUIRED", "error": { "code": "invalid_api_key", "message": "No API key was sent with the request. Nothing was charged. Please check that the full key is sent in the Authorization header as \"Bearer \". Request ID: .", "param": null, "reason": "invalid_api_key", "request_id": "", "type": "invalid_request_error" }, "message": "No API key was sent with the request. Nothing was charged. …" } } }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Public error classes: invalid_api_key, api_key_disabled.", "headers": { "Retry-After": { "description": "Wait the returned number of seconds before an allowed retry.", "schema": { "type": "string" } }, "X-Request-ID": { "description": "Preserve the original Request ID.", "schema": { "type": "string" } }, "X-Should-Retry": { "description": "false forbids automatic retry; unknown outcomes must be reconciled.", "schema": { "enum": [ "true", "false" ], "type": "string" } } } }, "402": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Public error classes: insufficient_balance, insufficient_quota, api_key_quota_exhausted, payment_disputed.", "headers": { "Retry-After": { "description": "Wait the returned number of seconds before an allowed retry.", "schema": { "type": "string" } }, "X-Request-ID": { "description": "Preserve the original Request ID.", "schema": { "type": "string" } }, "X-Should-Retry": { "description": "false forbids automatic retry; unknown outcomes must be reconciled.", "schema": { "enum": [ "true", "false" ], "type": "string" } } } }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Public error classes: api_key_expired, account_inactive, permission_denied.", "headers": { "Retry-After": { "description": "Wait the returned number of seconds before an allowed retry.", "schema": { "type": "string" } }, "X-Request-ID": { "description": "Preserve the original Request ID.", "schema": { "type": "string" } }, "X-Should-Retry": { "description": "false forbids automatic retry; unknown outcomes must be reconciled.", "schema": { "enum": [ "true", "false" ], "type": "string" } } } }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Public error classes: model_not_found, unsupported_endpoint, not_found.", "headers": { "Retry-After": { "description": "Wait the returned number of seconds before an allowed retry.", "schema": { "type": "string" } }, "X-Request-ID": { "description": "Preserve the original Request ID.", "schema": { "type": "string" } }, "X-Should-Retry": { "description": "false forbids automatic retry; unknown outcomes must be reconciled.", "schema": { "enum": [ "true", "false" ], "type": "string" } } } }, "409": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Public error classes: duplicate_request, not_ready, video_not_ready, result_pending_check.", "headers": { "Retry-After": { "description": "Wait the returned number of seconds before an allowed retry.", "schema": { "type": "string" } }, "X-Request-ID": { "description": "Preserve the original Request ID.", "schema": { "type": "string" } }, "X-Should-Retry": { "description": "false forbids automatic retry; unknown outcomes must be reconciled.", "schema": { "enum": [ "true", "false" ], "type": "string" } } } }, "410": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Public error classes: model_retired.", "headers": { "Retry-After": { "description": "Wait the returned number of seconds before an allowed retry.", "schema": { "type": "string" } }, "X-Request-ID": { "description": "Preserve the original Request ID.", "schema": { "type": "string" } }, "X-Should-Retry": { "description": "false forbids automatic retry; unknown outcomes must be reconciled.", "schema": { "enum": [ "true", "false" ], "type": "string" } } } }, "413": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Public error classes: request_too_large.", "headers": { "Retry-After": { "description": "Wait the returned number of seconds before an allowed retry.", "schema": { "type": "string" } }, "X-Request-ID": { "description": "Preserve the original Request ID.", "schema": { "type": "string" } }, "X-Should-Retry": { "description": "false forbids automatic retry; unknown outcomes must be reconciled.", "schema": { "enum": [ "true", "false" ], "type": "string" } } } }, "429": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Public error classes: rate_limit_exceeded, gateway_concurrency_limit, gateway_queue_full, usage_limit_reached.", "headers": { "Retry-After": { "description": "Wait the returned number of seconds before an allowed retry.", "schema": { "type": "string" } }, "X-Request-ID": { "description": "Preserve the original Request ID.", "schema": { "type": "string" } }, "X-Should-Retry": { "description": "false forbids automatic retry; unknown outcomes must be reconciled.", "schema": { "enum": [ "true", "false" ], "type": "string" } } } }, "4XX": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Response shape depends on the selected model and method.", "headers": { "X-Request-ID": { "description": "Preserve the original Request ID.", "schema": { "type": "string" } } } }, "500": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Public error classes: internal_error.", "headers": { "Retry-After": { "description": "Wait the returned number of seconds before an allowed retry.", "schema": { "type": "string" } }, "X-Request-ID": { "description": "Preserve the original Request ID.", "schema": { "type": "string" } }, "X-Should-Retry": { "description": "false forbids automatic retry; unknown outcomes must be reconciled.", "schema": { "enum": [ "true", "false" ], "type": "string" } } } }, "502": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Public error classes: invalid_model_response, empty_response, incomplete_response, result_not_delivered.", "headers": { "Retry-After": { "description": "Wait the returned number of seconds before an allowed retry.", "schema": { "type": "string" } }, "X-Request-ID": { "description": "Preserve the original Request ID.", "schema": { "type": "string" } }, "X-Should-Retry": { "description": "false forbids automatic retry; unknown outcomes must be reconciled.", "schema": { "enum": [ "true", "false" ], "type": "string" } } } }, "503": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Public error classes: model_overloaded, model_unavailable, service_unavailable, charge_not_confirmed, result_pending_check.", "headers": { "Retry-After": { "description": "Wait the returned number of seconds before an allowed retry.", "schema": { "type": "string" } }, "X-Request-ID": { "description": "Preserve the original Request ID.", "schema": { "type": "string" } }, "X-Should-Retry": { "description": "false forbids automatic retry; unknown outcomes must be reconciled.", "schema": { "enum": [ "true", "false" ], "type": "string" } } } }, "504": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Public error classes: model_timeout.", "headers": { "Retry-After": { "description": "Wait the returned number of seconds before an allowed retry.", "schema": { "type": "string" } }, "X-Request-ID": { "description": "Preserve the original Request ID.", "schema": { "type": "string" } }, "X-Should-Retry": { "description": "false forbids automatic retry; unknown outcomes must be reconciled.", "schema": { "enum": [ "true", "false" ], "type": "string" } } } }, "5XX": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Response shape depends on the selected model and method.", "headers": { "X-Request-ID": { "description": "Preserve the original Request ID.", "schema": { "type": "string" } } } } }, "security": [ { "clientBearer": [] } ], "summary": "Create a response" } }, "/v1/systemone": { "post": { "operationId": "createSystemOne", "requestBody": { "content": { "application/json": { "example": { "model": "jev-latest", "questions": { "is_urgent": { "instructions": "Does this convey urgency?", "type": "noul" } }, "state": "Help! My payouts have been failing for 3 days." }, "schema": { "$ref": "#/components/schemas/SystemOneRequest" } } }, "required": true }, "responses": { "200": { "content": { "application/json": { "example": { "answers": { "is_urgent": { "noul": 0.95, "type": "noul" } }, "model": "jev-1.13.0", "usage": { "input_tokens": 296, "output_tokens": 20 } }, "schema": { "$ref": "#/components/schemas/SystemOneResponse" } } }, "description": "Completed documented response.", "headers": { "X-Request-ID": { "description": "Preserve the original Request ID.", "schema": { "type": "string" } } } }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Public error classes: invalid_request, context_length_exceeded, content_policy_violation.", "headers": { "Retry-After": { "description": "Wait the returned number of seconds before an allowed retry.", "schema": { "type": "string" } }, "X-Request-ID": { "description": "Preserve the original Request ID.", "schema": { "type": "string" } }, "X-Should-Retry": { "description": "false forbids automatic retry; unknown outcomes must be reconciled.", "schema": { "enum": [ "true", "false" ], "type": "string" } } } }, "401": { "content": { "application/json": { "examples": { "anthropic": { "value": { "error": { "code": "invalid_api_key", "message": "… Nothing was charged. … Request ID: .", "reason": "invalid_api_key", "type": "authentication_error" }, "request_id": "", "type": "error" } }, "gemini": { "value": { "error": { "code": 401, "details": [ { "@type": "type.googleapis.com/google.rpc.ErrorInfo", "domain": "ailoot.ai", "metadata": { "code": "invalid_api_key", "reason": "invalid_api_key", "request_id": "" }, "reason": "INVALID_API_KEY" }, { "@type": "type.googleapis.com/google.rpc.RequestInfo", "requestId": "" } ], "message": "The API key is not valid. Nothing was charged. … Request ID: .", "status": "UNAUTHENTICATED" } } }, "openai": { "value": { "code": "API_KEY_REQUIRED", "error": { "code": "invalid_api_key", "message": "No API key was sent with the request. Nothing was charged. Please check that the full key is sent in the Authorization header as \"Bearer \". Request ID: .", "param": null, "reason": "invalid_api_key", "request_id": "", "type": "invalid_request_error" }, "message": "No API key was sent with the request. Nothing was charged. …" } } }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Public error classes: invalid_api_key, api_key_disabled.", "headers": { "Retry-After": { "description": "Wait the returned number of seconds before an allowed retry.", "schema": { "type": "string" } }, "X-Request-ID": { "description": "Preserve the original Request ID.", "schema": { "type": "string" } }, "X-Should-Retry": { "description": "false forbids automatic retry; unknown outcomes must be reconciled.", "schema": { "enum": [ "true", "false" ], "type": "string" } } } }, "402": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Public error classes: insufficient_balance, insufficient_quota, api_key_quota_exhausted, payment_disputed.", "headers": { "Retry-After": { "description": "Wait the returned number of seconds before an allowed retry.", "schema": { "type": "string" } }, "X-Request-ID": { "description": "Preserve the original Request ID.", "schema": { "type": "string" } }, "X-Should-Retry": { "description": "false forbids automatic retry; unknown outcomes must be reconciled.", "schema": { "enum": [ "true", "false" ], "type": "string" } } } }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Public error classes: api_key_expired, account_inactive, permission_denied.", "headers": { "Retry-After": { "description": "Wait the returned number of seconds before an allowed retry.", "schema": { "type": "string" } }, "X-Request-ID": { "description": "Preserve the original Request ID.", "schema": { "type": "string" } }, "X-Should-Retry": { "description": "false forbids automatic retry; unknown outcomes must be reconciled.", "schema": { "enum": [ "true", "false" ], "type": "string" } } } }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Public error classes: model_not_found, unsupported_endpoint, not_found.", "headers": { "Retry-After": { "description": "Wait the returned number of seconds before an allowed retry.", "schema": { "type": "string" } }, "X-Request-ID": { "description": "Preserve the original Request ID.", "schema": { "type": "string" } }, "X-Should-Retry": { "description": "false forbids automatic retry; unknown outcomes must be reconciled.", "schema": { "enum": [ "true", "false" ], "type": "string" } } } }, "409": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Public error classes: duplicate_request, not_ready, video_not_ready, result_pending_check.", "headers": { "Retry-After": { "description": "Wait the returned number of seconds before an allowed retry.", "schema": { "type": "string" } }, "X-Request-ID": { "description": "Preserve the original Request ID.", "schema": { "type": "string" } }, "X-Should-Retry": { "description": "false forbids automatic retry; unknown outcomes must be reconciled.", "schema": { "enum": [ "true", "false" ], "type": "string" } } } }, "410": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Public error classes: model_retired.", "headers": { "Retry-After": { "description": "Wait the returned number of seconds before an allowed retry.", "schema": { "type": "string" } }, "X-Request-ID": { "description": "Preserve the original Request ID.", "schema": { "type": "string" } }, "X-Should-Retry": { "description": "false forbids automatic retry; unknown outcomes must be reconciled.", "schema": { "enum": [ "true", "false" ], "type": "string" } } } }, "413": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Public error classes: request_too_large.", "headers": { "Retry-After": { "description": "Wait the returned number of seconds before an allowed retry.", "schema": { "type": "string" } }, "X-Request-ID": { "description": "Preserve the original Request ID.", "schema": { "type": "string" } }, "X-Should-Retry": { "description": "false forbids automatic retry; unknown outcomes must be reconciled.", "schema": { "enum": [ "true", "false" ], "type": "string" } } } }, "429": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Public error classes: rate_limit_exceeded, gateway_concurrency_limit, gateway_queue_full, usage_limit_reached.", "headers": { "Retry-After": { "description": "Wait the returned number of seconds before an allowed retry.", "schema": { "type": "string" } }, "X-Request-ID": { "description": "Preserve the original Request ID.", "schema": { "type": "string" } }, "X-Should-Retry": { "description": "false forbids automatic retry; unknown outcomes must be reconciled.", "schema": { "enum": [ "true", "false" ], "type": "string" } } } }, "500": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Public error classes: internal_error.", "headers": { "Retry-After": { "description": "Wait the returned number of seconds before an allowed retry.", "schema": { "type": "string" } }, "X-Request-ID": { "description": "Preserve the original Request ID.", "schema": { "type": "string" } }, "X-Should-Retry": { "description": "false forbids automatic retry; unknown outcomes must be reconciled.", "schema": { "enum": [ "true", "false" ], "type": "string" } } } }, "502": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Public error classes: invalid_model_response, empty_response, incomplete_response, result_not_delivered.", "headers": { "Retry-After": { "description": "Wait the returned number of seconds before an allowed retry.", "schema": { "type": "string" } }, "X-Request-ID": { "description": "Preserve the original Request ID.", "schema": { "type": "string" } }, "X-Should-Retry": { "description": "false forbids automatic retry; unknown outcomes must be reconciled.", "schema": { "enum": [ "true", "false" ], "type": "string" } } } }, "503": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Public error classes: model_overloaded, model_unavailable, service_unavailable, charge_not_confirmed, result_pending_check.", "headers": { "Retry-After": { "description": "Wait the returned number of seconds before an allowed retry.", "schema": { "type": "string" } }, "X-Request-ID": { "description": "Preserve the original Request ID.", "schema": { "type": "string" } }, "X-Should-Retry": { "description": "false forbids automatic retry; unknown outcomes must be reconciled.", "schema": { "enum": [ "true", "false" ], "type": "string" } } } }, "504": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Public error classes: model_timeout.", "headers": { "Retry-After": { "description": "Wait the returned number of seconds before an allowed retry.", "schema": { "type": "string" } }, "X-Request-ID": { "description": "Preserve the original Request ID.", "schema": { "type": "string" } }, "X-Should-Retry": { "description": "false forbids automatic retry; unknown outcomes must be reconciled.", "schema": { "enum": [ "true", "false" ], "type": "string" } } } } }, "security": [ { "clientBearer": [] } ], "summary": "Answer typed decision questions" } }, "/v1/videos": { "post": { "description": "Save the returned task identifier. Poll status and download content; do not repeat creation after a timeout or unknown result. Required media parameters differ by model; this documented example is not a parameter guarantee for every video model.", "operationId": "createVideoCompatible", "requestBody": { "content": { "application/json": { "example": { "duration": 6, "model": "grok-imagine-video-1.5", "prompt": "Calm sea waves at dawn, no text." }, "schema": { "$ref": "#/components/schemas/VideoRequest" } } }, "required": true }, "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/VideoJob" } } }, "description": "Response shape depends on the selected model and method.", "headers": { "X-Request-ID": { "description": "Preserve the original Request ID.", "schema": { "type": "string" } } } }, "202": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/VideoJob" } } }, "description": "Google Omni accepted the original video task with queued status. Save its returned identifier and Request ID; poll the original task status and download through /content after completion; do not repeat creation.", "headers": { "X-Request-ID": { "description": "Preserve the original Request ID.", "schema": { "type": "string" } } } }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Public error classes: invalid_request, context_length_exceeded, content_policy_violation.", "headers": { "Retry-After": { "description": "Wait the returned number of seconds before an allowed retry.", "schema": { "type": "string" } }, "X-Request-ID": { "description": "Preserve the original Request ID.", "schema": { "type": "string" } }, "X-Should-Retry": { "description": "false forbids automatic retry; unknown outcomes must be reconciled.", "schema": { "enum": [ "true", "false" ], "type": "string" } } } }, "401": { "content": { "application/json": { "examples": { "anthropic": { "value": { "error": { "code": "invalid_api_key", "message": "… Nothing was charged. … Request ID: .", "reason": "invalid_api_key", "type": "authentication_error" }, "request_id": "", "type": "error" } }, "gemini": { "value": { "error": { "code": 401, "details": [ { "@type": "type.googleapis.com/google.rpc.ErrorInfo", "domain": "ailoot.ai", "metadata": { "code": "invalid_api_key", "reason": "invalid_api_key", "request_id": "" }, "reason": "INVALID_API_KEY" }, { "@type": "type.googleapis.com/google.rpc.RequestInfo", "requestId": "" } ], "message": "The API key is not valid. Nothing was charged. … Request ID: .", "status": "UNAUTHENTICATED" } } }, "openai": { "value": { "code": "API_KEY_REQUIRED", "error": { "code": "invalid_api_key", "message": "No API key was sent with the request. Nothing was charged. Please check that the full key is sent in the Authorization header as \"Bearer \". Request ID: .", "param": null, "reason": "invalid_api_key", "request_id": "", "type": "invalid_request_error" }, "message": "No API key was sent with the request. Nothing was charged. …" } } }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Public error classes: invalid_api_key, api_key_disabled.", "headers": { "Retry-After": { "description": "Wait the returned number of seconds before an allowed retry.", "schema": { "type": "string" } }, "X-Request-ID": { "description": "Preserve the original Request ID.", "schema": { "type": "string" } }, "X-Should-Retry": { "description": "false forbids automatic retry; unknown outcomes must be reconciled.", "schema": { "enum": [ "true", "false" ], "type": "string" } } } }, "402": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Public error classes: insufficient_balance, insufficient_quota, api_key_quota_exhausted, payment_disputed.", "headers": { "Retry-After": { "description": "Wait the returned number of seconds before an allowed retry.", "schema": { "type": "string" } }, "X-Request-ID": { "description": "Preserve the original Request ID.", "schema": { "type": "string" } }, "X-Should-Retry": { "description": "false forbids automatic retry; unknown outcomes must be reconciled.", "schema": { "enum": [ "true", "false" ], "type": "string" } } } }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Public error classes: api_key_expired, account_inactive, permission_denied.", "headers": { "Retry-After": { "description": "Wait the returned number of seconds before an allowed retry.", "schema": { "type": "string" } }, "X-Request-ID": { "description": "Preserve the original Request ID.", "schema": { "type": "string" } }, "X-Should-Retry": { "description": "false forbids automatic retry; unknown outcomes must be reconciled.", "schema": { "enum": [ "true", "false" ], "type": "string" } } } }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Public error classes: model_not_found, unsupported_endpoint, not_found.", "headers": { "Retry-After": { "description": "Wait the returned number of seconds before an allowed retry.", "schema": { "type": "string" } }, "X-Request-ID": { "description": "Preserve the original Request ID.", "schema": { "type": "string" } }, "X-Should-Retry": { "description": "false forbids automatic retry; unknown outcomes must be reconciled.", "schema": { "enum": [ "true", "false" ], "type": "string" } } } }, "409": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Public error classes: duplicate_request, not_ready, video_not_ready, result_pending_check.", "headers": { "Retry-After": { "description": "Wait the returned number of seconds before an allowed retry.", "schema": { "type": "string" } }, "X-Request-ID": { "description": "Preserve the original Request ID.", "schema": { "type": "string" } }, "X-Should-Retry": { "description": "false forbids automatic retry; unknown outcomes must be reconciled.", "schema": { "enum": [ "true", "false" ], "type": "string" } } } }, "410": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Public error classes: model_retired.", "headers": { "Retry-After": { "description": "Wait the returned number of seconds before an allowed retry.", "schema": { "type": "string" } }, "X-Request-ID": { "description": "Preserve the original Request ID.", "schema": { "type": "string" } }, "X-Should-Retry": { "description": "false forbids automatic retry; unknown outcomes must be reconciled.", "schema": { "enum": [ "true", "false" ], "type": "string" } } } }, "413": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Public error classes: request_too_large.", "headers": { "Retry-After": { "description": "Wait the returned number of seconds before an allowed retry.", "schema": { "type": "string" } }, "X-Request-ID": { "description": "Preserve the original Request ID.", "schema": { "type": "string" } }, "X-Should-Retry": { "description": "false forbids automatic retry; unknown outcomes must be reconciled.", "schema": { "enum": [ "true", "false" ], "type": "string" } } } }, "429": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Public error classes: rate_limit_exceeded, gateway_concurrency_limit, gateway_queue_full, usage_limit_reached.", "headers": { "Retry-After": { "description": "Wait the returned number of seconds before an allowed retry.", "schema": { "type": "string" } }, "X-Request-ID": { "description": "Preserve the original Request ID.", "schema": { "type": "string" } }, "X-Should-Retry": { "description": "false forbids automatic retry; unknown outcomes must be reconciled.", "schema": { "enum": [ "true", "false" ], "type": "string" } } } }, "4XX": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Response shape depends on the selected model and method.", "headers": { "X-Request-ID": { "description": "Preserve the original Request ID.", "schema": { "type": "string" } } } }, "500": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Public error classes: internal_error.", "headers": { "Retry-After": { "description": "Wait the returned number of seconds before an allowed retry.", "schema": { "type": "string" } }, "X-Request-ID": { "description": "Preserve the original Request ID.", "schema": { "type": "string" } }, "X-Should-Retry": { "description": "false forbids automatic retry; unknown outcomes must be reconciled.", "schema": { "enum": [ "true", "false" ], "type": "string" } } } }, "502": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Public error classes: invalid_model_response, empty_response, incomplete_response, result_not_delivered.", "headers": { "Retry-After": { "description": "Wait the returned number of seconds before an allowed retry.", "schema": { "type": "string" } }, "X-Request-ID": { "description": "Preserve the original Request ID.", "schema": { "type": "string" } }, "X-Should-Retry": { "description": "false forbids automatic retry; unknown outcomes must be reconciled.", "schema": { "enum": [ "true", "false" ], "type": "string" } } } }, "503": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Public error classes: model_overloaded, model_unavailable, service_unavailable, charge_not_confirmed, result_pending_check.", "headers": { "Retry-After": { "description": "Wait the returned number of seconds before an allowed retry.", "schema": { "type": "string" } }, "X-Request-ID": { "description": "Preserve the original Request ID.", "schema": { "type": "string" } }, "X-Should-Retry": { "description": "false forbids automatic retry; unknown outcomes must be reconciled.", "schema": { "enum": [ "true", "false" ], "type": "string" } } } }, "504": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Public error classes: model_timeout.", "headers": { "Retry-After": { "description": "Wait the returned number of seconds before an allowed retry.", "schema": { "type": "string" } }, "X-Request-ID": { "description": "Preserve the original Request ID.", "schema": { "type": "string" } }, "X-Should-Retry": { "description": "false forbids automatic retry; unknown outcomes must be reconciled.", "schema": { "enum": [ "true", "false" ], "type": "string" } } } }, "5XX": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Response shape depends on the selected model and method.", "headers": { "X-Request-ID": { "description": "Preserve the original Request ID.", "schema": { "type": "string" } } } } }, "security": [ { "clientBearer": [] } ], "summary": "Create a video task" } }, "/v1/videos/generations": { "post": { "description": "Save the returned task identifier. Poll status and download content; do not repeat creation after a timeout or unknown result. Required media parameters differ by model; this documented example is not a parameter guarantee for every video model.", "operationId": "createVideo", "requestBody": { "content": { "application/json": { "example": { "duration": 6, "model": "grok-imagine-video-1.5", "prompt": "Calm sea waves at dawn, no text." }, "schema": { "$ref": "#/components/schemas/VideoRequest" } } }, "required": true }, "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/VideoJob" } } }, "description": "Response shape depends on the selected model and method.", "headers": { "X-Request-ID": { "description": "Preserve the original Request ID.", "schema": { "type": "string" } } } }, "202": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/VideoJob" } } }, "description": "Google Omni accepted the original video task with queued status. Save its returned identifier and Request ID; poll the original task status and download through /content after completion; do not repeat creation.", "headers": { "X-Request-ID": { "description": "Preserve the original Request ID.", "schema": { "type": "string" } } } }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Public error classes: invalid_request, context_length_exceeded, content_policy_violation.", "headers": { "Retry-After": { "description": "Wait the returned number of seconds before an allowed retry.", "schema": { "type": "string" } }, "X-Request-ID": { "description": "Preserve the original Request ID.", "schema": { "type": "string" } }, "X-Should-Retry": { "description": "false forbids automatic retry; unknown outcomes must be reconciled.", "schema": { "enum": [ "true", "false" ], "type": "string" } } } }, "401": { "content": { "application/json": { "examples": { "anthropic": { "value": { "error": { "code": "invalid_api_key", "message": "… Nothing was charged. … Request ID: .", "reason": "invalid_api_key", "type": "authentication_error" }, "request_id": "", "type": "error" } }, "gemini": { "value": { "error": { "code": 401, "details": [ { "@type": "type.googleapis.com/google.rpc.ErrorInfo", "domain": "ailoot.ai", "metadata": { "code": "invalid_api_key", "reason": "invalid_api_key", "request_id": "" }, "reason": "INVALID_API_KEY" }, { "@type": "type.googleapis.com/google.rpc.RequestInfo", "requestId": "" } ], "message": "The API key is not valid. Nothing was charged. … Request ID: .", "status": "UNAUTHENTICATED" } } }, "openai": { "value": { "code": "API_KEY_REQUIRED", "error": { "code": "invalid_api_key", "message": "No API key was sent with the request. Nothing was charged. Please check that the full key is sent in the Authorization header as \"Bearer \". Request ID: .", "param": null, "reason": "invalid_api_key", "request_id": "", "type": "invalid_request_error" }, "message": "No API key was sent with the request. Nothing was charged. …" } } }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Public error classes: invalid_api_key, api_key_disabled.", "headers": { "Retry-After": { "description": "Wait the returned number of seconds before an allowed retry.", "schema": { "type": "string" } }, "X-Request-ID": { "description": "Preserve the original Request ID.", "schema": { "type": "string" } }, "X-Should-Retry": { "description": "false forbids automatic retry; unknown outcomes must be reconciled.", "schema": { "enum": [ "true", "false" ], "type": "string" } } } }, "402": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Public error classes: insufficient_balance, insufficient_quota, api_key_quota_exhausted, payment_disputed.", "headers": { "Retry-After": { "description": "Wait the returned number of seconds before an allowed retry.", "schema": { "type": "string" } }, "X-Request-ID": { "description": "Preserve the original Request ID.", "schema": { "type": "string" } }, "X-Should-Retry": { "description": "false forbids automatic retry; unknown outcomes must be reconciled.", "schema": { "enum": [ "true", "false" ], "type": "string" } } } }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Public error classes: api_key_expired, account_inactive, permission_denied.", "headers": { "Retry-After": { "description": "Wait the returned number of seconds before an allowed retry.", "schema": { "type": "string" } }, "X-Request-ID": { "description": "Preserve the original Request ID.", "schema": { "type": "string" } }, "X-Should-Retry": { "description": "false forbids automatic retry; unknown outcomes must be reconciled.", "schema": { "enum": [ "true", "false" ], "type": "string" } } } }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Public error classes: model_not_found, unsupported_endpoint, not_found.", "headers": { "Retry-After": { "description": "Wait the returned number of seconds before an allowed retry.", "schema": { "type": "string" } }, "X-Request-ID": { "description": "Preserve the original Request ID.", "schema": { "type": "string" } }, "X-Should-Retry": { "description": "false forbids automatic retry; unknown outcomes must be reconciled.", "schema": { "enum": [ "true", "false" ], "type": "string" } } } }, "409": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Public error classes: duplicate_request, not_ready, video_not_ready, result_pending_check.", "headers": { "Retry-After": { "description": "Wait the returned number of seconds before an allowed retry.", "schema": { "type": "string" } }, "X-Request-ID": { "description": "Preserve the original Request ID.", "schema": { "type": "string" } }, "X-Should-Retry": { "description": "false forbids automatic retry; unknown outcomes must be reconciled.", "schema": { "enum": [ "true", "false" ], "type": "string" } } } }, "410": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Public error classes: model_retired.", "headers": { "Retry-After": { "description": "Wait the returned number of seconds before an allowed retry.", "schema": { "type": "string" } }, "X-Request-ID": { "description": "Preserve the original Request ID.", "schema": { "type": "string" } }, "X-Should-Retry": { "description": "false forbids automatic retry; unknown outcomes must be reconciled.", "schema": { "enum": [ "true", "false" ], "type": "string" } } } }, "413": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Public error classes: request_too_large.", "headers": { "Retry-After": { "description": "Wait the returned number of seconds before an allowed retry.", "schema": { "type": "string" } }, "X-Request-ID": { "description": "Preserve the original Request ID.", "schema": { "type": "string" } }, "X-Should-Retry": { "description": "false forbids automatic retry; unknown outcomes must be reconciled.", "schema": { "enum": [ "true", "false" ], "type": "string" } } } }, "429": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Public error classes: rate_limit_exceeded, gateway_concurrency_limit, gateway_queue_full, usage_limit_reached.", "headers": { "Retry-After": { "description": "Wait the returned number of seconds before an allowed retry.", "schema": { "type": "string" } }, "X-Request-ID": { "description": "Preserve the original Request ID.", "schema": { "type": "string" } }, "X-Should-Retry": { "description": "false forbids automatic retry; unknown outcomes must be reconciled.", "schema": { "enum": [ "true", "false" ], "type": "string" } } } }, "4XX": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Response shape depends on the selected model and method.", "headers": { "X-Request-ID": { "description": "Preserve the original Request ID.", "schema": { "type": "string" } } } }, "500": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Public error classes: internal_error.", "headers": { "Retry-After": { "description": "Wait the returned number of seconds before an allowed retry.", "schema": { "type": "string" } }, "X-Request-ID": { "description": "Preserve the original Request ID.", "schema": { "type": "string" } }, "X-Should-Retry": { "description": "false forbids automatic retry; unknown outcomes must be reconciled.", "schema": { "enum": [ "true", "false" ], "type": "string" } } } }, "502": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Public error classes: invalid_model_response, empty_response, incomplete_response, result_not_delivered.", "headers": { "Retry-After": { "description": "Wait the returned number of seconds before an allowed retry.", "schema": { "type": "string" } }, "X-Request-ID": { "description": "Preserve the original Request ID.", "schema": { "type": "string" } }, "X-Should-Retry": { "description": "false forbids automatic retry; unknown outcomes must be reconciled.", "schema": { "enum": [ "true", "false" ], "type": "string" } } } }, "503": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Public error classes: model_overloaded, model_unavailable, service_unavailable, charge_not_confirmed, result_pending_check.", "headers": { "Retry-After": { "description": "Wait the returned number of seconds before an allowed retry.", "schema": { "type": "string" } }, "X-Request-ID": { "description": "Preserve the original Request ID.", "schema": { "type": "string" } }, "X-Should-Retry": { "description": "false forbids automatic retry; unknown outcomes must be reconciled.", "schema": { "enum": [ "true", "false" ], "type": "string" } } } }, "504": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Public error classes: model_timeout.", "headers": { "Retry-After": { "description": "Wait the returned number of seconds before an allowed retry.", "schema": { "type": "string" } }, "X-Request-ID": { "description": "Preserve the original Request ID.", "schema": { "type": "string" } }, "X-Should-Retry": { "description": "false forbids automatic retry; unknown outcomes must be reconciled.", "schema": { "enum": [ "true", "false" ], "type": "string" } } } }, "5XX": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Response shape depends on the selected model and method.", "headers": { "X-Request-ID": { "description": "Preserve the original Request ID.", "schema": { "type": "string" } } } } }, "security": [ { "clientBearer": [] } ], "summary": "Create a video task" } }, "/v1/videos/generations/{request_id}": { "get": { "operationId": "getVideoGeneration", "parameters": [ { "description": "Use the identifier returned by this API; do not invent or reuse another owner's ID.", "in": "path", "name": "request_id", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/VideoJob" } } }, "description": "Response shape depends on the selected model and method.", "headers": { "X-Request-ID": { "description": "Preserve the original Request ID.", "schema": { "type": "string" } } } }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Public error classes: invalid_request, context_length_exceeded, content_policy_violation.", "headers": { "Retry-After": { "description": "Wait the returned number of seconds before an allowed retry.", "schema": { "type": "string" } }, "X-Request-ID": { "description": "Preserve the original Request ID.", "schema": { "type": "string" } }, "X-Should-Retry": { "description": "false forbids automatic retry; unknown outcomes must be reconciled.", "schema": { "enum": [ "true", "false" ], "type": "string" } } } }, "401": { "content": { "application/json": { "examples": { "anthropic": { "value": { "error": { "code": "invalid_api_key", "message": "… Nothing was charged. … Request ID: .", "reason": "invalid_api_key", "type": "authentication_error" }, "request_id": "", "type": "error" } }, "gemini": { "value": { "error": { "code": 401, "details": [ { "@type": "type.googleapis.com/google.rpc.ErrorInfo", "domain": "ailoot.ai", "metadata": { "code": "invalid_api_key", "reason": "invalid_api_key", "request_id": "" }, "reason": "INVALID_API_KEY" }, { "@type": "type.googleapis.com/google.rpc.RequestInfo", "requestId": "" } ], "message": "The API key is not valid. Nothing was charged. … Request ID: .", "status": "UNAUTHENTICATED" } } }, "openai": { "value": { "code": "API_KEY_REQUIRED", "error": { "code": "invalid_api_key", "message": "No API key was sent with the request. Nothing was charged. Please check that the full key is sent in the Authorization header as \"Bearer \". Request ID: .", "param": null, "reason": "invalid_api_key", "request_id": "", "type": "invalid_request_error" }, "message": "No API key was sent with the request. Nothing was charged. …" } } }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Public error classes: invalid_api_key, api_key_disabled.", "headers": { "Retry-After": { "description": "Wait the returned number of seconds before an allowed retry.", "schema": { "type": "string" } }, "X-Request-ID": { "description": "Preserve the original Request ID.", "schema": { "type": "string" } }, "X-Should-Retry": { "description": "false forbids automatic retry; unknown outcomes must be reconciled.", "schema": { "enum": [ "true", "false" ], "type": "string" } } } }, "402": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Public error classes: insufficient_balance, insufficient_quota, api_key_quota_exhausted, payment_disputed.", "headers": { "Retry-After": { "description": "Wait the returned number of seconds before an allowed retry.", "schema": { "type": "string" } }, "X-Request-ID": { "description": "Preserve the original Request ID.", "schema": { "type": "string" } }, "X-Should-Retry": { "description": "false forbids automatic retry; unknown outcomes must be reconciled.", "schema": { "enum": [ "true", "false" ], "type": "string" } } } }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Public error classes: api_key_expired, account_inactive, permission_denied.", "headers": { "Retry-After": { "description": "Wait the returned number of seconds before an allowed retry.", "schema": { "type": "string" } }, "X-Request-ID": { "description": "Preserve the original Request ID.", "schema": { "type": "string" } }, "X-Should-Retry": { "description": "false forbids automatic retry; unknown outcomes must be reconciled.", "schema": { "enum": [ "true", "false" ], "type": "string" } } } }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Public error classes: model_not_found, unsupported_endpoint, not_found.", "headers": { "Retry-After": { "description": "Wait the returned number of seconds before an allowed retry.", "schema": { "type": "string" } }, "X-Request-ID": { "description": "Preserve the original Request ID.", "schema": { "type": "string" } }, "X-Should-Retry": { "description": "false forbids automatic retry; unknown outcomes must be reconciled.", "schema": { "enum": [ "true", "false" ], "type": "string" } } } }, "409": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Public error classes: duplicate_request, not_ready, video_not_ready, result_pending_check.", "headers": { "Retry-After": { "description": "Wait the returned number of seconds before an allowed retry.", "schema": { "type": "string" } }, "X-Request-ID": { "description": "Preserve the original Request ID.", "schema": { "type": "string" } }, "X-Should-Retry": { "description": "false forbids automatic retry; unknown outcomes must be reconciled.", "schema": { "enum": [ "true", "false" ], "type": "string" } } } }, "410": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Public error classes: model_retired.", "headers": { "Retry-After": { "description": "Wait the returned number of seconds before an allowed retry.", "schema": { "type": "string" } }, "X-Request-ID": { "description": "Preserve the original Request ID.", "schema": { "type": "string" } }, "X-Should-Retry": { "description": "false forbids automatic retry; unknown outcomes must be reconciled.", "schema": { "enum": [ "true", "false" ], "type": "string" } } } }, "413": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Public error classes: request_too_large.", "headers": { "Retry-After": { "description": "Wait the returned number of seconds before an allowed retry.", "schema": { "type": "string" } }, "X-Request-ID": { "description": "Preserve the original Request ID.", "schema": { "type": "string" } }, "X-Should-Retry": { "description": "false forbids automatic retry; unknown outcomes must be reconciled.", "schema": { "enum": [ "true", "false" ], "type": "string" } } } }, "429": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Public error classes: rate_limit_exceeded, gateway_concurrency_limit, gateway_queue_full, usage_limit_reached.", "headers": { "Retry-After": { "description": "Wait the returned number of seconds before an allowed retry.", "schema": { "type": "string" } }, "X-Request-ID": { "description": "Preserve the original Request ID.", "schema": { "type": "string" } }, "X-Should-Retry": { "description": "false forbids automatic retry; unknown outcomes must be reconciled.", "schema": { "enum": [ "true", "false" ], "type": "string" } } } }, "4XX": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Response shape depends on the selected model and method.", "headers": { "X-Request-ID": { "description": "Preserve the original Request ID.", "schema": { "type": "string" } } } }, "500": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Public error classes: internal_error.", "headers": { "Retry-After": { "description": "Wait the returned number of seconds before an allowed retry.", "schema": { "type": "string" } }, "X-Request-ID": { "description": "Preserve the original Request ID.", "schema": { "type": "string" } }, "X-Should-Retry": { "description": "false forbids automatic retry; unknown outcomes must be reconciled.", "schema": { "enum": [ "true", "false" ], "type": "string" } } } }, "502": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Public error classes: invalid_model_response, empty_response, incomplete_response, result_not_delivered.", "headers": { "Retry-After": { "description": "Wait the returned number of seconds before an allowed retry.", "schema": { "type": "string" } }, "X-Request-ID": { "description": "Preserve the original Request ID.", "schema": { "type": "string" } }, "X-Should-Retry": { "description": "false forbids automatic retry; unknown outcomes must be reconciled.", "schema": { "enum": [ "true", "false" ], "type": "string" } } } }, "503": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Public error classes: model_overloaded, model_unavailable, service_unavailable, charge_not_confirmed, result_pending_check.", "headers": { "Retry-After": { "description": "Wait the returned number of seconds before an allowed retry.", "schema": { "type": "string" } }, "X-Request-ID": { "description": "Preserve the original Request ID.", "schema": { "type": "string" } }, "X-Should-Retry": { "description": "false forbids automatic retry; unknown outcomes must be reconciled.", "schema": { "enum": [ "true", "false" ], "type": "string" } } } }, "504": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Public error classes: model_timeout.", "headers": { "Retry-After": { "description": "Wait the returned number of seconds before an allowed retry.", "schema": { "type": "string" } }, "X-Request-ID": { "description": "Preserve the original Request ID.", "schema": { "type": "string" } }, "X-Should-Retry": { "description": "false forbids automatic retry; unknown outcomes must be reconciled.", "schema": { "enum": [ "true", "false" ], "type": "string" } } } }, "5XX": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Response shape depends on the selected model and method.", "headers": { "X-Request-ID": { "description": "Preserve the original Request ID.", "schema": { "type": "string" } } } } }, "security": [ { "clientBearer": [] } ], "summary": "Read the original video task status" } }, "/v1/videos/generations/{request_id}/content": { "get": { "operationId": "getVideoGenerationContent", "parameters": [ { "description": "Use the identifier returned by this API; do not invent or reuse another owner's ID.", "in": "path", "name": "request_id", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "content": { "video/mp4": {} }, "description": "Owned video bytes after completion.", "headers": { "X-Request-ID": { "description": "Preserve the original Request ID.", "schema": { "type": "string" } } } }, "3XX": { "description": "Documented redirect to a signed file: follow the returned redirect target to download the original video. The exact status code is not specified by the public video guide; this response range does not select a specific code.", "headers": { "X-Request-ID": { "description": "Preserve the original Request ID.", "schema": { "type": "string" } } } }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Public error classes: invalid_request, context_length_exceeded, content_policy_violation.", "headers": { "Retry-After": { "description": "Wait the returned number of seconds before an allowed retry.", "schema": { "type": "string" } }, "X-Request-ID": { "description": "Preserve the original Request ID.", "schema": { "type": "string" } }, "X-Should-Retry": { "description": "false forbids automatic retry; unknown outcomes must be reconciled.", "schema": { "enum": [ "true", "false" ], "type": "string" } } } }, "401": { "content": { "application/json": { "examples": { "anthropic": { "value": { "error": { "code": "invalid_api_key", "message": "… Nothing was charged. … Request ID: .", "reason": "invalid_api_key", "type": "authentication_error" }, "request_id": "", "type": "error" } }, "gemini": { "value": { "error": { "code": 401, "details": [ { "@type": "type.googleapis.com/google.rpc.ErrorInfo", "domain": "ailoot.ai", "metadata": { "code": "invalid_api_key", "reason": "invalid_api_key", "request_id": "" }, "reason": "INVALID_API_KEY" }, { "@type": "type.googleapis.com/google.rpc.RequestInfo", "requestId": "" } ], "message": "The API key is not valid. Nothing was charged. … Request ID: .", "status": "UNAUTHENTICATED" } } }, "openai": { "value": { "code": "API_KEY_REQUIRED", "error": { "code": "invalid_api_key", "message": "No API key was sent with the request. Nothing was charged. Please check that the full key is sent in the Authorization header as \"Bearer \". Request ID: .", "param": null, "reason": "invalid_api_key", "request_id": "", "type": "invalid_request_error" }, "message": "No API key was sent with the request. Nothing was charged. …" } } }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Public error classes: invalid_api_key, api_key_disabled.", "headers": { "Retry-After": { "description": "Wait the returned number of seconds before an allowed retry.", "schema": { "type": "string" } }, "X-Request-ID": { "description": "Preserve the original Request ID.", "schema": { "type": "string" } }, "X-Should-Retry": { "description": "false forbids automatic retry; unknown outcomes must be reconciled.", "schema": { "enum": [ "true", "false" ], "type": "string" } } } }, "402": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Public error classes: insufficient_balance, insufficient_quota, api_key_quota_exhausted, payment_disputed.", "headers": { "Retry-After": { "description": "Wait the returned number of seconds before an allowed retry.", "schema": { "type": "string" } }, "X-Request-ID": { "description": "Preserve the original Request ID.", "schema": { "type": "string" } }, "X-Should-Retry": { "description": "false forbids automatic retry; unknown outcomes must be reconciled.", "schema": { "enum": [ "true", "false" ], "type": "string" } } } }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Public error classes: api_key_expired, account_inactive, permission_denied.", "headers": { "Retry-After": { "description": "Wait the returned number of seconds before an allowed retry.", "schema": { "type": "string" } }, "X-Request-ID": { "description": "Preserve the original Request ID.", "schema": { "type": "string" } }, "X-Should-Retry": { "description": "false forbids automatic retry; unknown outcomes must be reconciled.", "schema": { "enum": [ "true", "false" ], "type": "string" } } } }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Public error classes: model_not_found, unsupported_endpoint, not_found.", "headers": { "Retry-After": { "description": "Wait the returned number of seconds before an allowed retry.", "schema": { "type": "string" } }, "X-Request-ID": { "description": "Preserve the original Request ID.", "schema": { "type": "string" } }, "X-Should-Retry": { "description": "false forbids automatic retry; unknown outcomes must be reconciled.", "schema": { "enum": [ "true", "false" ], "type": "string" } } } }, "409": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Public error classes: duplicate_request, not_ready, video_not_ready, result_pending_check.", "headers": { "Retry-After": { "description": "Wait the returned number of seconds before an allowed retry.", "schema": { "type": "string" } }, "X-Request-ID": { "description": "Preserve the original Request ID.", "schema": { "type": "string" } }, "X-Should-Retry": { "description": "false forbids automatic retry; unknown outcomes must be reconciled.", "schema": { "enum": [ "true", "false" ], "type": "string" } } } }, "410": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Public error classes: model_retired.", "headers": { "Retry-After": { "description": "Wait the returned number of seconds before an allowed retry.", "schema": { "type": "string" } }, "X-Request-ID": { "description": "Preserve the original Request ID.", "schema": { "type": "string" } }, "X-Should-Retry": { "description": "false forbids automatic retry; unknown outcomes must be reconciled.", "schema": { "enum": [ "true", "false" ], "type": "string" } } } }, "413": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Public error classes: request_too_large.", "headers": { "Retry-After": { "description": "Wait the returned number of seconds before an allowed retry.", "schema": { "type": "string" } }, "X-Request-ID": { "description": "Preserve the original Request ID.", "schema": { "type": "string" } }, "X-Should-Retry": { "description": "false forbids automatic retry; unknown outcomes must be reconciled.", "schema": { "enum": [ "true", "false" ], "type": "string" } } } }, "429": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Public error classes: rate_limit_exceeded, gateway_concurrency_limit, gateway_queue_full, usage_limit_reached.", "headers": { "Retry-After": { "description": "Wait the returned number of seconds before an allowed retry.", "schema": { "type": "string" } }, "X-Request-ID": { "description": "Preserve the original Request ID.", "schema": { "type": "string" } }, "X-Should-Retry": { "description": "false forbids automatic retry; unknown outcomes must be reconciled.", "schema": { "enum": [ "true", "false" ], "type": "string" } } } }, "4XX": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Response shape depends on the selected model and method.", "headers": { "X-Request-ID": { "description": "Preserve the original Request ID.", "schema": { "type": "string" } } } }, "500": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Public error classes: internal_error.", "headers": { "Retry-After": { "description": "Wait the returned number of seconds before an allowed retry.", "schema": { "type": "string" } }, "X-Request-ID": { "description": "Preserve the original Request ID.", "schema": { "type": "string" } }, "X-Should-Retry": { "description": "false forbids automatic retry; unknown outcomes must be reconciled.", "schema": { "enum": [ "true", "false" ], "type": "string" } } } }, "502": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Public error classes: invalid_model_response, empty_response, incomplete_response, result_not_delivered.", "headers": { "Retry-After": { "description": "Wait the returned number of seconds before an allowed retry.", "schema": { "type": "string" } }, "X-Request-ID": { "description": "Preserve the original Request ID.", "schema": { "type": "string" } }, "X-Should-Retry": { "description": "false forbids automatic retry; unknown outcomes must be reconciled.", "schema": { "enum": [ "true", "false" ], "type": "string" } } } }, "503": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Public error classes: model_overloaded, model_unavailable, service_unavailable, charge_not_confirmed, result_pending_check.", "headers": { "Retry-After": { "description": "Wait the returned number of seconds before an allowed retry.", "schema": { "type": "string" } }, "X-Request-ID": { "description": "Preserve the original Request ID.", "schema": { "type": "string" } }, "X-Should-Retry": { "description": "false forbids automatic retry; unknown outcomes must be reconciled.", "schema": { "enum": [ "true", "false" ], "type": "string" } } } }, "504": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Public error classes: model_timeout.", "headers": { "Retry-After": { "description": "Wait the returned number of seconds before an allowed retry.", "schema": { "type": "string" } }, "X-Request-ID": { "description": "Preserve the original Request ID.", "schema": { "type": "string" } }, "X-Should-Retry": { "description": "false forbids automatic retry; unknown outcomes must be reconciled.", "schema": { "enum": [ "true", "false" ], "type": "string" } } } }, "5XX": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Response shape depends on the selected model and method.", "headers": { "X-Request-ID": { "description": "Preserve the original Request ID.", "schema": { "type": "string" } } } } }, "security": [ { "clientBearer": [] } ], "summary": "Download the original completed video" } }, "/v1/videos/{request_id}": { "get": { "operationId": "getVideo", "parameters": [ { "description": "Use the identifier returned by this API; do not invent or reuse another owner's ID.", "in": "path", "name": "request_id", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/VideoJob" } } }, "description": "Response shape depends on the selected model and method.", "headers": { "X-Request-ID": { "description": "Preserve the original Request ID.", "schema": { "type": "string" } } } }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Public error classes: invalid_request, context_length_exceeded, content_policy_violation.", "headers": { "Retry-After": { "description": "Wait the returned number of seconds before an allowed retry.", "schema": { "type": "string" } }, "X-Request-ID": { "description": "Preserve the original Request ID.", "schema": { "type": "string" } }, "X-Should-Retry": { "description": "false forbids automatic retry; unknown outcomes must be reconciled.", "schema": { "enum": [ "true", "false" ], "type": "string" } } } }, "401": { "content": { "application/json": { "examples": { "anthropic": { "value": { "error": { "code": "invalid_api_key", "message": "… Nothing was charged. … Request ID: .", "reason": "invalid_api_key", "type": "authentication_error" }, "request_id": "", "type": "error" } }, "gemini": { "value": { "error": { "code": 401, "details": [ { "@type": "type.googleapis.com/google.rpc.ErrorInfo", "domain": "ailoot.ai", "metadata": { "code": "invalid_api_key", "reason": "invalid_api_key", "request_id": "" }, "reason": "INVALID_API_KEY" }, { "@type": "type.googleapis.com/google.rpc.RequestInfo", "requestId": "" } ], "message": "The API key is not valid. Nothing was charged. … Request ID: .", "status": "UNAUTHENTICATED" } } }, "openai": { "value": { "code": "API_KEY_REQUIRED", "error": { "code": "invalid_api_key", "message": "No API key was sent with the request. Nothing was charged. Please check that the full key is sent in the Authorization header as \"Bearer \". Request ID: .", "param": null, "reason": "invalid_api_key", "request_id": "", "type": "invalid_request_error" }, "message": "No API key was sent with the request. Nothing was charged. …" } } }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Public error classes: invalid_api_key, api_key_disabled.", "headers": { "Retry-After": { "description": "Wait the returned number of seconds before an allowed retry.", "schema": { "type": "string" } }, "X-Request-ID": { "description": "Preserve the original Request ID.", "schema": { "type": "string" } }, "X-Should-Retry": { "description": "false forbids automatic retry; unknown outcomes must be reconciled.", "schema": { "enum": [ "true", "false" ], "type": "string" } } } }, "402": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Public error classes: insufficient_balance, insufficient_quota, api_key_quota_exhausted, payment_disputed.", "headers": { "Retry-After": { "description": "Wait the returned number of seconds before an allowed retry.", "schema": { "type": "string" } }, "X-Request-ID": { "description": "Preserve the original Request ID.", "schema": { "type": "string" } }, "X-Should-Retry": { "description": "false forbids automatic retry; unknown outcomes must be reconciled.", "schema": { "enum": [ "true", "false" ], "type": "string" } } } }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Public error classes: api_key_expired, account_inactive, permission_denied.", "headers": { "Retry-After": { "description": "Wait the returned number of seconds before an allowed retry.", "schema": { "type": "string" } }, "X-Request-ID": { "description": "Preserve the original Request ID.", "schema": { "type": "string" } }, "X-Should-Retry": { "description": "false forbids automatic retry; unknown outcomes must be reconciled.", "schema": { "enum": [ "true", "false" ], "type": "string" } } } }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Public error classes: model_not_found, unsupported_endpoint, not_found.", "headers": { "Retry-After": { "description": "Wait the returned number of seconds before an allowed retry.", "schema": { "type": "string" } }, "X-Request-ID": { "description": "Preserve the original Request ID.", "schema": { "type": "string" } }, "X-Should-Retry": { "description": "false forbids automatic retry; unknown outcomes must be reconciled.", "schema": { "enum": [ "true", "false" ], "type": "string" } } } }, "409": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Public error classes: duplicate_request, not_ready, video_not_ready, result_pending_check.", "headers": { "Retry-After": { "description": "Wait the returned number of seconds before an allowed retry.", "schema": { "type": "string" } }, "X-Request-ID": { "description": "Preserve the original Request ID.", "schema": { "type": "string" } }, "X-Should-Retry": { "description": "false forbids automatic retry; unknown outcomes must be reconciled.", "schema": { "enum": [ "true", "false" ], "type": "string" } } } }, "410": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Public error classes: model_retired.", "headers": { "Retry-After": { "description": "Wait the returned number of seconds before an allowed retry.", "schema": { "type": "string" } }, "X-Request-ID": { "description": "Preserve the original Request ID.", "schema": { "type": "string" } }, "X-Should-Retry": { "description": "false forbids automatic retry; unknown outcomes must be reconciled.", "schema": { "enum": [ "true", "false" ], "type": "string" } } } }, "413": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Public error classes: request_too_large.", "headers": { "Retry-After": { "description": "Wait the returned number of seconds before an allowed retry.", "schema": { "type": "string" } }, "X-Request-ID": { "description": "Preserve the original Request ID.", "schema": { "type": "string" } }, "X-Should-Retry": { "description": "false forbids automatic retry; unknown outcomes must be reconciled.", "schema": { "enum": [ "true", "false" ], "type": "string" } } } }, "429": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Public error classes: rate_limit_exceeded, gateway_concurrency_limit, gateway_queue_full, usage_limit_reached.", "headers": { "Retry-After": { "description": "Wait the returned number of seconds before an allowed retry.", "schema": { "type": "string" } }, "X-Request-ID": { "description": "Preserve the original Request ID.", "schema": { "type": "string" } }, "X-Should-Retry": { "description": "false forbids automatic retry; unknown outcomes must be reconciled.", "schema": { "enum": [ "true", "false" ], "type": "string" } } } }, "4XX": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Response shape depends on the selected model and method.", "headers": { "X-Request-ID": { "description": "Preserve the original Request ID.", "schema": { "type": "string" } } } }, "500": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Public error classes: internal_error.", "headers": { "Retry-After": { "description": "Wait the returned number of seconds before an allowed retry.", "schema": { "type": "string" } }, "X-Request-ID": { "description": "Preserve the original Request ID.", "schema": { "type": "string" } }, "X-Should-Retry": { "description": "false forbids automatic retry; unknown outcomes must be reconciled.", "schema": { "enum": [ "true", "false" ], "type": "string" } } } }, "502": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Public error classes: invalid_model_response, empty_response, incomplete_response, result_not_delivered.", "headers": { "Retry-After": { "description": "Wait the returned number of seconds before an allowed retry.", "schema": { "type": "string" } }, "X-Request-ID": { "description": "Preserve the original Request ID.", "schema": { "type": "string" } }, "X-Should-Retry": { "description": "false forbids automatic retry; unknown outcomes must be reconciled.", "schema": { "enum": [ "true", "false" ], "type": "string" } } } }, "503": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Public error classes: model_overloaded, model_unavailable, service_unavailable, charge_not_confirmed, result_pending_check.", "headers": { "Retry-After": { "description": "Wait the returned number of seconds before an allowed retry.", "schema": { "type": "string" } }, "X-Request-ID": { "description": "Preserve the original Request ID.", "schema": { "type": "string" } }, "X-Should-Retry": { "description": "false forbids automatic retry; unknown outcomes must be reconciled.", "schema": { "enum": [ "true", "false" ], "type": "string" } } } }, "504": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Public error classes: model_timeout.", "headers": { "Retry-After": { "description": "Wait the returned number of seconds before an allowed retry.", "schema": { "type": "string" } }, "X-Request-ID": { "description": "Preserve the original Request ID.", "schema": { "type": "string" } }, "X-Should-Retry": { "description": "false forbids automatic retry; unknown outcomes must be reconciled.", "schema": { "enum": [ "true", "false" ], "type": "string" } } } }, "5XX": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Response shape depends on the selected model and method.", "headers": { "X-Request-ID": { "description": "Preserve the original Request ID.", "schema": { "type": "string" } } } } }, "security": [ { "clientBearer": [] } ], "summary": "Read the original video task status" } }, "/v1/videos/{request_id}/content": { "get": { "operationId": "getVideoContent", "parameters": [ { "description": "Use the identifier returned by this API; do not invent or reuse another owner's ID.", "in": "path", "name": "request_id", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "content": { "video/mp4": {} }, "description": "Owned video bytes after completion.", "headers": { "X-Request-ID": { "description": "Preserve the original Request ID.", "schema": { "type": "string" } } } }, "3XX": { "description": "Documented redirect to a signed file: follow the returned redirect target to download the original video. The exact status code is not specified by the public video guide; this response range does not select a specific code.", "headers": { "X-Request-ID": { "description": "Preserve the original Request ID.", "schema": { "type": "string" } } } }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Public error classes: invalid_request, context_length_exceeded, content_policy_violation.", "headers": { "Retry-After": { "description": "Wait the returned number of seconds before an allowed retry.", "schema": { "type": "string" } }, "X-Request-ID": { "description": "Preserve the original Request ID.", "schema": { "type": "string" } }, "X-Should-Retry": { "description": "false forbids automatic retry; unknown outcomes must be reconciled.", "schema": { "enum": [ "true", "false" ], "type": "string" } } } }, "401": { "content": { "application/json": { "examples": { "anthropic": { "value": { "error": { "code": "invalid_api_key", "message": "… Nothing was charged. … Request ID: .", "reason": "invalid_api_key", "type": "authentication_error" }, "request_id": "", "type": "error" } }, "gemini": { "value": { "error": { "code": 401, "details": [ { "@type": "type.googleapis.com/google.rpc.ErrorInfo", "domain": "ailoot.ai", "metadata": { "code": "invalid_api_key", "reason": "invalid_api_key", "request_id": "" }, "reason": "INVALID_API_KEY" }, { "@type": "type.googleapis.com/google.rpc.RequestInfo", "requestId": "" } ], "message": "The API key is not valid. Nothing was charged. … Request ID: .", "status": "UNAUTHENTICATED" } } }, "openai": { "value": { "code": "API_KEY_REQUIRED", "error": { "code": "invalid_api_key", "message": "No API key was sent with the request. Nothing was charged. Please check that the full key is sent in the Authorization header as \"Bearer \". Request ID: .", "param": null, "reason": "invalid_api_key", "request_id": "", "type": "invalid_request_error" }, "message": "No API key was sent with the request. Nothing was charged. …" } } }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Public error classes: invalid_api_key, api_key_disabled.", "headers": { "Retry-After": { "description": "Wait the returned number of seconds before an allowed retry.", "schema": { "type": "string" } }, "X-Request-ID": { "description": "Preserve the original Request ID.", "schema": { "type": "string" } }, "X-Should-Retry": { "description": "false forbids automatic retry; unknown outcomes must be reconciled.", "schema": { "enum": [ "true", "false" ], "type": "string" } } } }, "402": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Public error classes: insufficient_balance, insufficient_quota, api_key_quota_exhausted, payment_disputed.", "headers": { "Retry-After": { "description": "Wait the returned number of seconds before an allowed retry.", "schema": { "type": "string" } }, "X-Request-ID": { "description": "Preserve the original Request ID.", "schema": { "type": "string" } }, "X-Should-Retry": { "description": "false forbids automatic retry; unknown outcomes must be reconciled.", "schema": { "enum": [ "true", "false" ], "type": "string" } } } }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Public error classes: api_key_expired, account_inactive, permission_denied.", "headers": { "Retry-After": { "description": "Wait the returned number of seconds before an allowed retry.", "schema": { "type": "string" } }, "X-Request-ID": { "description": "Preserve the original Request ID.", "schema": { "type": "string" } }, "X-Should-Retry": { "description": "false forbids automatic retry; unknown outcomes must be reconciled.", "schema": { "enum": [ "true", "false" ], "type": "string" } } } }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Public error classes: model_not_found, unsupported_endpoint, not_found.", "headers": { "Retry-After": { "description": "Wait the returned number of seconds before an allowed retry.", "schema": { "type": "string" } }, "X-Request-ID": { "description": "Preserve the original Request ID.", "schema": { "type": "string" } }, "X-Should-Retry": { "description": "false forbids automatic retry; unknown outcomes must be reconciled.", "schema": { "enum": [ "true", "false" ], "type": "string" } } } }, "409": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Public error classes: duplicate_request, not_ready, video_not_ready, result_pending_check.", "headers": { "Retry-After": { "description": "Wait the returned number of seconds before an allowed retry.", "schema": { "type": "string" } }, "X-Request-ID": { "description": "Preserve the original Request ID.", "schema": { "type": "string" } }, "X-Should-Retry": { "description": "false forbids automatic retry; unknown outcomes must be reconciled.", "schema": { "enum": [ "true", "false" ], "type": "string" } } } }, "410": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Public error classes: model_retired.", "headers": { "Retry-After": { "description": "Wait the returned number of seconds before an allowed retry.", "schema": { "type": "string" } }, "X-Request-ID": { "description": "Preserve the original Request ID.", "schema": { "type": "string" } }, "X-Should-Retry": { "description": "false forbids automatic retry; unknown outcomes must be reconciled.", "schema": { "enum": [ "true", "false" ], "type": "string" } } } }, "413": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Public error classes: request_too_large.", "headers": { "Retry-After": { "description": "Wait the returned number of seconds before an allowed retry.", "schema": { "type": "string" } }, "X-Request-ID": { "description": "Preserve the original Request ID.", "schema": { "type": "string" } }, "X-Should-Retry": { "description": "false forbids automatic retry; unknown outcomes must be reconciled.", "schema": { "enum": [ "true", "false" ], "type": "string" } } } }, "429": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Public error classes: rate_limit_exceeded, gateway_concurrency_limit, gateway_queue_full, usage_limit_reached.", "headers": { "Retry-After": { "description": "Wait the returned number of seconds before an allowed retry.", "schema": { "type": "string" } }, "X-Request-ID": { "description": "Preserve the original Request ID.", "schema": { "type": "string" } }, "X-Should-Retry": { "description": "false forbids automatic retry; unknown outcomes must be reconciled.", "schema": { "enum": [ "true", "false" ], "type": "string" } } } }, "4XX": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Response shape depends on the selected model and method.", "headers": { "X-Request-ID": { "description": "Preserve the original Request ID.", "schema": { "type": "string" } } } }, "500": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Public error classes: internal_error.", "headers": { "Retry-After": { "description": "Wait the returned number of seconds before an allowed retry.", "schema": { "type": "string" } }, "X-Request-ID": { "description": "Preserve the original Request ID.", "schema": { "type": "string" } }, "X-Should-Retry": { "description": "false forbids automatic retry; unknown outcomes must be reconciled.", "schema": { "enum": [ "true", "false" ], "type": "string" } } } }, "502": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Public error classes: invalid_model_response, empty_response, incomplete_response, result_not_delivered.", "headers": { "Retry-After": { "description": "Wait the returned number of seconds before an allowed retry.", "schema": { "type": "string" } }, "X-Request-ID": { "description": "Preserve the original Request ID.", "schema": { "type": "string" } }, "X-Should-Retry": { "description": "false forbids automatic retry; unknown outcomes must be reconciled.", "schema": { "enum": [ "true", "false" ], "type": "string" } } } }, "503": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Public error classes: model_overloaded, model_unavailable, service_unavailable, charge_not_confirmed, result_pending_check.", "headers": { "Retry-After": { "description": "Wait the returned number of seconds before an allowed retry.", "schema": { "type": "string" } }, "X-Request-ID": { "description": "Preserve the original Request ID.", "schema": { "type": "string" } }, "X-Should-Retry": { "description": "false forbids automatic retry; unknown outcomes must be reconciled.", "schema": { "enum": [ "true", "false" ], "type": "string" } } } }, "504": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Public error classes: model_timeout.", "headers": { "Retry-After": { "description": "Wait the returned number of seconds before an allowed retry.", "schema": { "type": "string" } }, "X-Request-ID": { "description": "Preserve the original Request ID.", "schema": { "type": "string" } }, "X-Should-Retry": { "description": "false forbids automatic retry; unknown outcomes must be reconciled.", "schema": { "enum": [ "true", "false" ], "type": "string" } } } }, "5XX": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Response shape depends on the selected model and method.", "headers": { "X-Request-ID": { "description": "Preserve the original Request ID.", "schema": { "type": "string" } } } } }, "security": [ { "clientBearer": [] } ], "summary": "Download the original completed video" } }, "/v1beta/models": { "get": { "operationId": "listGeminiModels", "responses": { "200": { "content": { "application/json": { "schema": {} } }, "description": "Completed documented response.", "headers": { "X-Request-ID": { "description": "Preserve the original Request ID.", "schema": { "type": "string" } } } }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Public error classes: invalid_request, context_length_exceeded, content_policy_violation.", "headers": { "Retry-After": { "description": "Wait the returned number of seconds before an allowed retry.", "schema": { "type": "string" } }, "X-Request-ID": { "description": "Preserve the original Request ID.", "schema": { "type": "string" } }, "X-Should-Retry": { "description": "false forbids automatic retry; unknown outcomes must be reconciled.", "schema": { "enum": [ "true", "false" ], "type": "string" } } } }, "401": { "content": { "application/json": { "examples": { "anthropic": { "value": { "error": { "code": "invalid_api_key", "message": "… Nothing was charged. … Request ID: .", "reason": "invalid_api_key", "type": "authentication_error" }, "request_id": "", "type": "error" } }, "gemini": { "value": { "error": { "code": 401, "details": [ { "@type": "type.googleapis.com/google.rpc.ErrorInfo", "domain": "ailoot.ai", "metadata": { "code": "invalid_api_key", "reason": "invalid_api_key", "request_id": "" }, "reason": "INVALID_API_KEY" }, { "@type": "type.googleapis.com/google.rpc.RequestInfo", "requestId": "" } ], "message": "The API key is not valid. Nothing was charged. … Request ID: .", "status": "UNAUTHENTICATED" } } }, "openai": { "value": { "code": "API_KEY_REQUIRED", "error": { "code": "invalid_api_key", "message": "No API key was sent with the request. Nothing was charged. Please check that the full key is sent in the Authorization header as \"Bearer \". Request ID: .", "param": null, "reason": "invalid_api_key", "request_id": "", "type": "invalid_request_error" }, "message": "No API key was sent with the request. Nothing was charged. …" } } }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Public error classes: invalid_api_key, api_key_disabled.", "headers": { "Retry-After": { "description": "Wait the returned number of seconds before an allowed retry.", "schema": { "type": "string" } }, "X-Request-ID": { "description": "Preserve the original Request ID.", "schema": { "type": "string" } }, "X-Should-Retry": { "description": "false forbids automatic retry; unknown outcomes must be reconciled.", "schema": { "enum": [ "true", "false" ], "type": "string" } } } }, "402": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Public error classes: insufficient_balance, insufficient_quota, api_key_quota_exhausted, payment_disputed.", "headers": { "Retry-After": { "description": "Wait the returned number of seconds before an allowed retry.", "schema": { "type": "string" } }, "X-Request-ID": { "description": "Preserve the original Request ID.", "schema": { "type": "string" } }, "X-Should-Retry": { "description": "false forbids automatic retry; unknown outcomes must be reconciled.", "schema": { "enum": [ "true", "false" ], "type": "string" } } } }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Public error classes: api_key_expired, account_inactive, permission_denied.", "headers": { "Retry-After": { "description": "Wait the returned number of seconds before an allowed retry.", "schema": { "type": "string" } }, "X-Request-ID": { "description": "Preserve the original Request ID.", "schema": { "type": "string" } }, "X-Should-Retry": { "description": "false forbids automatic retry; unknown outcomes must be reconciled.", "schema": { "enum": [ "true", "false" ], "type": "string" } } } }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Public error classes: model_not_found, unsupported_endpoint, not_found.", "headers": { "Retry-After": { "description": "Wait the returned number of seconds before an allowed retry.", "schema": { "type": "string" } }, "X-Request-ID": { "description": "Preserve the original Request ID.", "schema": { "type": "string" } }, "X-Should-Retry": { "description": "false forbids automatic retry; unknown outcomes must be reconciled.", "schema": { "enum": [ "true", "false" ], "type": "string" } } } }, "409": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Public error classes: duplicate_request, not_ready, video_not_ready, result_pending_check.", "headers": { "Retry-After": { "description": "Wait the returned number of seconds before an allowed retry.", "schema": { "type": "string" } }, "X-Request-ID": { "description": "Preserve the original Request ID.", "schema": { "type": "string" } }, "X-Should-Retry": { "description": "false forbids automatic retry; unknown outcomes must be reconciled.", "schema": { "enum": [ "true", "false" ], "type": "string" } } } }, "410": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Public error classes: model_retired.", "headers": { "Retry-After": { "description": "Wait the returned number of seconds before an allowed retry.", "schema": { "type": "string" } }, "X-Request-ID": { "description": "Preserve the original Request ID.", "schema": { "type": "string" } }, "X-Should-Retry": { "description": "false forbids automatic retry; unknown outcomes must be reconciled.", "schema": { "enum": [ "true", "false" ], "type": "string" } } } }, "413": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Public error classes: request_too_large.", "headers": { "Retry-After": { "description": "Wait the returned number of seconds before an allowed retry.", "schema": { "type": "string" } }, "X-Request-ID": { "description": "Preserve the original Request ID.", "schema": { "type": "string" } }, "X-Should-Retry": { "description": "false forbids automatic retry; unknown outcomes must be reconciled.", "schema": { "enum": [ "true", "false" ], "type": "string" } } } }, "429": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Public error classes: rate_limit_exceeded, gateway_concurrency_limit, gateway_queue_full, usage_limit_reached.", "headers": { "Retry-After": { "description": "Wait the returned number of seconds before an allowed retry.", "schema": { "type": "string" } }, "X-Request-ID": { "description": "Preserve the original Request ID.", "schema": { "type": "string" } }, "X-Should-Retry": { "description": "false forbids automatic retry; unknown outcomes must be reconciled.", "schema": { "enum": [ "true", "false" ], "type": "string" } } } }, "500": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Public error classes: internal_error.", "headers": { "Retry-After": { "description": "Wait the returned number of seconds before an allowed retry.", "schema": { "type": "string" } }, "X-Request-ID": { "description": "Preserve the original Request ID.", "schema": { "type": "string" } }, "X-Should-Retry": { "description": "false forbids automatic retry; unknown outcomes must be reconciled.", "schema": { "enum": [ "true", "false" ], "type": "string" } } } }, "502": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Public error classes: invalid_model_response, empty_response, incomplete_response, result_not_delivered.", "headers": { "Retry-After": { "description": "Wait the returned number of seconds before an allowed retry.", "schema": { "type": "string" } }, "X-Request-ID": { "description": "Preserve the original Request ID.", "schema": { "type": "string" } }, "X-Should-Retry": { "description": "false forbids automatic retry; unknown outcomes must be reconciled.", "schema": { "enum": [ "true", "false" ], "type": "string" } } } }, "503": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Public error classes: model_overloaded, model_unavailable, service_unavailable, charge_not_confirmed, result_pending_check.", "headers": { "Retry-After": { "description": "Wait the returned number of seconds before an allowed retry.", "schema": { "type": "string" } }, "X-Request-ID": { "description": "Preserve the original Request ID.", "schema": { "type": "string" } }, "X-Should-Retry": { "description": "false forbids automatic retry; unknown outcomes must be reconciled.", "schema": { "enum": [ "true", "false" ], "type": "string" } } } }, "504": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Public error classes: model_timeout.", "headers": { "Retry-After": { "description": "Wait the returned number of seconds before an allowed retry.", "schema": { "type": "string" } }, "X-Request-ID": { "description": "Preserve the original Request ID.", "schema": { "type": "string" } }, "X-Should-Retry": { "description": "false forbids automatic retry; unknown outcomes must be reconciled.", "schema": { "enum": [ "true", "false" ], "type": "string" } } } } }, "security": [ { "clientBearer": [] } ], "summary": "List client models in Gemini format" } }, "/v1beta/models/{model}:generateContent": { "post": { "operationId": "generateContent", "parameters": [ { "description": "Use the identifier returned by this API; do not invent or reuse another owner's ID.", "in": "path", "name": "model", "required": true, "schema": { "type": "string" } } ], "requestBody": { "content": { "application/json": { "example": { "contents": [ { "parts": [ { "text": "What is 41 + 52? Answer with a single number." } ], "role": "user" } ], "generationConfig": { "maxOutputTokens": 4096 } }, "schema": { "$ref": "#/components/schemas/GenerateContentRequest" } } }, "required": true }, "responses": { "200": { "content": { "application/json": { "example": { "candidates": [ { "content": { "parts": [ { "text": "1. «Bean and Steam» 2. «Morning Grind» 3. «The Corner Café»" } ], "role": "model" }, "finishReason": "STOP" } ], "modelVersion": "gemini-3.8-flash", "usageMetadata": { "candidatesTokenCount": 27, "promptTokenCount": 9, "totalTokenCount": 36 } }, "schema": { "$ref": "#/components/schemas/GenerateContentResponse" } } }, "description": "Response shape depends on the selected model and method.", "headers": { "X-Request-ID": { "description": "Preserve the original Request ID.", "schema": { "type": "string" } } } }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Public error classes: invalid_request, context_length_exceeded, content_policy_violation.", "headers": { "Retry-After": { "description": "Wait the returned number of seconds before an allowed retry.", "schema": { "type": "string" } }, "X-Request-ID": { "description": "Preserve the original Request ID.", "schema": { "type": "string" } }, "X-Should-Retry": { "description": "false forbids automatic retry; unknown outcomes must be reconciled.", "schema": { "enum": [ "true", "false" ], "type": "string" } } } }, "401": { "content": { "application/json": { "examples": { "anthropic": { "value": { "error": { "code": "invalid_api_key", "message": "… Nothing was charged. … Request ID: .", "reason": "invalid_api_key", "type": "authentication_error" }, "request_id": "", "type": "error" } }, "gemini": { "value": { "error": { "code": 401, "details": [ { "@type": "type.googleapis.com/google.rpc.ErrorInfo", "domain": "ailoot.ai", "metadata": { "code": "invalid_api_key", "reason": "invalid_api_key", "request_id": "" }, "reason": "INVALID_API_KEY" }, { "@type": "type.googleapis.com/google.rpc.RequestInfo", "requestId": "" } ], "message": "The API key is not valid. Nothing was charged. … Request ID: .", "status": "UNAUTHENTICATED" } } }, "openai": { "value": { "code": "API_KEY_REQUIRED", "error": { "code": "invalid_api_key", "message": "No API key was sent with the request. Nothing was charged. Please check that the full key is sent in the Authorization header as \"Bearer \". Request ID: .", "param": null, "reason": "invalid_api_key", "request_id": "", "type": "invalid_request_error" }, "message": "No API key was sent with the request. Nothing was charged. …" } } }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Public error classes: invalid_api_key, api_key_disabled.", "headers": { "Retry-After": { "description": "Wait the returned number of seconds before an allowed retry.", "schema": { "type": "string" } }, "X-Request-ID": { "description": "Preserve the original Request ID.", "schema": { "type": "string" } }, "X-Should-Retry": { "description": "false forbids automatic retry; unknown outcomes must be reconciled.", "schema": { "enum": [ "true", "false" ], "type": "string" } } } }, "402": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Public error classes: insufficient_balance, insufficient_quota, api_key_quota_exhausted, payment_disputed.", "headers": { "Retry-After": { "description": "Wait the returned number of seconds before an allowed retry.", "schema": { "type": "string" } }, "X-Request-ID": { "description": "Preserve the original Request ID.", "schema": { "type": "string" } }, "X-Should-Retry": { "description": "false forbids automatic retry; unknown outcomes must be reconciled.", "schema": { "enum": [ "true", "false" ], "type": "string" } } } }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Public error classes: api_key_expired, account_inactive, permission_denied.", "headers": { "Retry-After": { "description": "Wait the returned number of seconds before an allowed retry.", "schema": { "type": "string" } }, "X-Request-ID": { "description": "Preserve the original Request ID.", "schema": { "type": "string" } }, "X-Should-Retry": { "description": "false forbids automatic retry; unknown outcomes must be reconciled.", "schema": { "enum": [ "true", "false" ], "type": "string" } } } }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Public error classes: model_not_found, unsupported_endpoint, not_found.", "headers": { "Retry-After": { "description": "Wait the returned number of seconds before an allowed retry.", "schema": { "type": "string" } }, "X-Request-ID": { "description": "Preserve the original Request ID.", "schema": { "type": "string" } }, "X-Should-Retry": { "description": "false forbids automatic retry; unknown outcomes must be reconciled.", "schema": { "enum": [ "true", "false" ], "type": "string" } } } }, "409": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Public error classes: duplicate_request, not_ready, video_not_ready, result_pending_check.", "headers": { "Retry-After": { "description": "Wait the returned number of seconds before an allowed retry.", "schema": { "type": "string" } }, "X-Request-ID": { "description": "Preserve the original Request ID.", "schema": { "type": "string" } }, "X-Should-Retry": { "description": "false forbids automatic retry; unknown outcomes must be reconciled.", "schema": { "enum": [ "true", "false" ], "type": "string" } } } }, "410": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Public error classes: model_retired.", "headers": { "Retry-After": { "description": "Wait the returned number of seconds before an allowed retry.", "schema": { "type": "string" } }, "X-Request-ID": { "description": "Preserve the original Request ID.", "schema": { "type": "string" } }, "X-Should-Retry": { "description": "false forbids automatic retry; unknown outcomes must be reconciled.", "schema": { "enum": [ "true", "false" ], "type": "string" } } } }, "413": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Public error classes: request_too_large.", "headers": { "Retry-After": { "description": "Wait the returned number of seconds before an allowed retry.", "schema": { "type": "string" } }, "X-Request-ID": { "description": "Preserve the original Request ID.", "schema": { "type": "string" } }, "X-Should-Retry": { "description": "false forbids automatic retry; unknown outcomes must be reconciled.", "schema": { "enum": [ "true", "false" ], "type": "string" } } } }, "429": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Public error classes: rate_limit_exceeded, gateway_concurrency_limit, gateway_queue_full, usage_limit_reached.", "headers": { "Retry-After": { "description": "Wait the returned number of seconds before an allowed retry.", "schema": { "type": "string" } }, "X-Request-ID": { "description": "Preserve the original Request ID.", "schema": { "type": "string" } }, "X-Should-Retry": { "description": "false forbids automatic retry; unknown outcomes must be reconciled.", "schema": { "enum": [ "true", "false" ], "type": "string" } } } }, "4XX": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Response shape depends on the selected model and method.", "headers": { "X-Request-ID": { "description": "Preserve the original Request ID.", "schema": { "type": "string" } } } }, "500": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Public error classes: internal_error.", "headers": { "Retry-After": { "description": "Wait the returned number of seconds before an allowed retry.", "schema": { "type": "string" } }, "X-Request-ID": { "description": "Preserve the original Request ID.", "schema": { "type": "string" } }, "X-Should-Retry": { "description": "false forbids automatic retry; unknown outcomes must be reconciled.", "schema": { "enum": [ "true", "false" ], "type": "string" } } } }, "502": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Public error classes: invalid_model_response, empty_response, incomplete_response, result_not_delivered.", "headers": { "Retry-After": { "description": "Wait the returned number of seconds before an allowed retry.", "schema": { "type": "string" } }, "X-Request-ID": { "description": "Preserve the original Request ID.", "schema": { "type": "string" } }, "X-Should-Retry": { "description": "false forbids automatic retry; unknown outcomes must be reconciled.", "schema": { "enum": [ "true", "false" ], "type": "string" } } } }, "503": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Public error classes: model_overloaded, model_unavailable, service_unavailable, charge_not_confirmed, result_pending_check.", "headers": { "Retry-After": { "description": "Wait the returned number of seconds before an allowed retry.", "schema": { "type": "string" } }, "X-Request-ID": { "description": "Preserve the original Request ID.", "schema": { "type": "string" } }, "X-Should-Retry": { "description": "false forbids automatic retry; unknown outcomes must be reconciled.", "schema": { "enum": [ "true", "false" ], "type": "string" } } } }, "504": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Public error classes: model_timeout.", "headers": { "Retry-After": { "description": "Wait the returned number of seconds before an allowed retry.", "schema": { "type": "string" } }, "X-Request-ID": { "description": "Preserve the original Request ID.", "schema": { "type": "string" } }, "X-Should-Retry": { "description": "false forbids automatic retry; unknown outcomes must be reconciled.", "schema": { "enum": [ "true", "false" ], "type": "string" } } } }, "5XX": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Response shape depends on the selected model and method.", "headers": { "X-Request-ID": { "description": "Preserve the original Request ID.", "schema": { "type": "string" } } } } }, "security": [ { "clientBearer": [] } ], "summary": "Generate content with the native protocol" } }, "/v1beta/models/{model}:streamGenerateContent": { "post": { "operationId": "streamGenerateContent", "parameters": [ { "description": "Use the identifier returned by this API; do not invent or reuse another owner's ID.", "in": "path", "name": "model", "required": true, "schema": { "type": "string" } }, { "example": "sse", "in": "query", "name": "alt", "required": false, "schema": { "enum": [ "sse" ], "type": "string" } } ], "requestBody": { "content": { "application/json": { "example": { "contents": [ { "parts": [ { "text": "What is 41 + 52? Answer with a single number." } ], "role": "user" } ], "generationConfig": { "maxOutputTokens": 4096 } }, "schema": { "$ref": "#/components/schemas/GenerateContentRequest" } } }, "required": true }, "responses": { "200": { "content": { "text/event-stream": { "schema": { "description": "Gemini stream; process complete output and usage, preserving all original parts.", "type": "string" } } }, "description": "Response shape depends on the selected model and method.", "headers": { "X-Request-ID": { "description": "Preserve the original Request ID.", "schema": { "type": "string" } } } }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Public error classes: invalid_request, context_length_exceeded, content_policy_violation.", "headers": { "Retry-After": { "description": "Wait the returned number of seconds before an allowed retry.", "schema": { "type": "string" } }, "X-Request-ID": { "description": "Preserve the original Request ID.", "schema": { "type": "string" } }, "X-Should-Retry": { "description": "false forbids automatic retry; unknown outcomes must be reconciled.", "schema": { "enum": [ "true", "false" ], "type": "string" } } } }, "401": { "content": { "application/json": { "examples": { "anthropic": { "value": { "error": { "code": "invalid_api_key", "message": "… Nothing was charged. … Request ID: .", "reason": "invalid_api_key", "type": "authentication_error" }, "request_id": "", "type": "error" } }, "gemini": { "value": { "error": { "code": 401, "details": [ { "@type": "type.googleapis.com/google.rpc.ErrorInfo", "domain": "ailoot.ai", "metadata": { "code": "invalid_api_key", "reason": "invalid_api_key", "request_id": "" }, "reason": "INVALID_API_KEY" }, { "@type": "type.googleapis.com/google.rpc.RequestInfo", "requestId": "" } ], "message": "The API key is not valid. Nothing was charged. … Request ID: .", "status": "UNAUTHENTICATED" } } }, "openai": { "value": { "code": "API_KEY_REQUIRED", "error": { "code": "invalid_api_key", "message": "No API key was sent with the request. Nothing was charged. Please check that the full key is sent in the Authorization header as \"Bearer \". Request ID: .", "param": null, "reason": "invalid_api_key", "request_id": "", "type": "invalid_request_error" }, "message": "No API key was sent with the request. Nothing was charged. …" } } }, "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Public error classes: invalid_api_key, api_key_disabled.", "headers": { "Retry-After": { "description": "Wait the returned number of seconds before an allowed retry.", "schema": { "type": "string" } }, "X-Request-ID": { "description": "Preserve the original Request ID.", "schema": { "type": "string" } }, "X-Should-Retry": { "description": "false forbids automatic retry; unknown outcomes must be reconciled.", "schema": { "enum": [ "true", "false" ], "type": "string" } } } }, "402": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Public error classes: insufficient_balance, insufficient_quota, api_key_quota_exhausted, payment_disputed.", "headers": { "Retry-After": { "description": "Wait the returned number of seconds before an allowed retry.", "schema": { "type": "string" } }, "X-Request-ID": { "description": "Preserve the original Request ID.", "schema": { "type": "string" } }, "X-Should-Retry": { "description": "false forbids automatic retry; unknown outcomes must be reconciled.", "schema": { "enum": [ "true", "false" ], "type": "string" } } } }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Public error classes: api_key_expired, account_inactive, permission_denied.", "headers": { "Retry-After": { "description": "Wait the returned number of seconds before an allowed retry.", "schema": { "type": "string" } }, "X-Request-ID": { "description": "Preserve the original Request ID.", "schema": { "type": "string" } }, "X-Should-Retry": { "description": "false forbids automatic retry; unknown outcomes must be reconciled.", "schema": { "enum": [ "true", "false" ], "type": "string" } } } }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Public error classes: model_not_found, unsupported_endpoint, not_found.", "headers": { "Retry-After": { "description": "Wait the returned number of seconds before an allowed retry.", "schema": { "type": "string" } }, "X-Request-ID": { "description": "Preserve the original Request ID.", "schema": { "type": "string" } }, "X-Should-Retry": { "description": "false forbids automatic retry; unknown outcomes must be reconciled.", "schema": { "enum": [ "true", "false" ], "type": "string" } } } }, "409": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Public error classes: duplicate_request, not_ready, video_not_ready, result_pending_check.", "headers": { "Retry-After": { "description": "Wait the returned number of seconds before an allowed retry.", "schema": { "type": "string" } }, "X-Request-ID": { "description": "Preserve the original Request ID.", "schema": { "type": "string" } }, "X-Should-Retry": { "description": "false forbids automatic retry; unknown outcomes must be reconciled.", "schema": { "enum": [ "true", "false" ], "type": "string" } } } }, "410": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Public error classes: model_retired.", "headers": { "Retry-After": { "description": "Wait the returned number of seconds before an allowed retry.", "schema": { "type": "string" } }, "X-Request-ID": { "description": "Preserve the original Request ID.", "schema": { "type": "string" } }, "X-Should-Retry": { "description": "false forbids automatic retry; unknown outcomes must be reconciled.", "schema": { "enum": [ "true", "false" ], "type": "string" } } } }, "413": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Public error classes: request_too_large.", "headers": { "Retry-After": { "description": "Wait the returned number of seconds before an allowed retry.", "schema": { "type": "string" } }, "X-Request-ID": { "description": "Preserve the original Request ID.", "schema": { "type": "string" } }, "X-Should-Retry": { "description": "false forbids automatic retry; unknown outcomes must be reconciled.", "schema": { "enum": [ "true", "false" ], "type": "string" } } } }, "429": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Public error classes: rate_limit_exceeded, gateway_concurrency_limit, gateway_queue_full, usage_limit_reached.", "headers": { "Retry-After": { "description": "Wait the returned number of seconds before an allowed retry.", "schema": { "type": "string" } }, "X-Request-ID": { "description": "Preserve the original Request ID.", "schema": { "type": "string" } }, "X-Should-Retry": { "description": "false forbids automatic retry; unknown outcomes must be reconciled.", "schema": { "enum": [ "true", "false" ], "type": "string" } } } }, "4XX": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Response shape depends on the selected model and method.", "headers": { "X-Request-ID": { "description": "Preserve the original Request ID.", "schema": { "type": "string" } } } }, "500": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Public error classes: internal_error.", "headers": { "Retry-After": { "description": "Wait the returned number of seconds before an allowed retry.", "schema": { "type": "string" } }, "X-Request-ID": { "description": "Preserve the original Request ID.", "schema": { "type": "string" } }, "X-Should-Retry": { "description": "false forbids automatic retry; unknown outcomes must be reconciled.", "schema": { "enum": [ "true", "false" ], "type": "string" } } } }, "502": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Public error classes: invalid_model_response, empty_response, incomplete_response, result_not_delivered.", "headers": { "Retry-After": { "description": "Wait the returned number of seconds before an allowed retry.", "schema": { "type": "string" } }, "X-Request-ID": { "description": "Preserve the original Request ID.", "schema": { "type": "string" } }, "X-Should-Retry": { "description": "false forbids automatic retry; unknown outcomes must be reconciled.", "schema": { "enum": [ "true", "false" ], "type": "string" } } } }, "503": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Public error classes: model_overloaded, model_unavailable, service_unavailable, charge_not_confirmed, result_pending_check.", "headers": { "Retry-After": { "description": "Wait the returned number of seconds before an allowed retry.", "schema": { "type": "string" } }, "X-Request-ID": { "description": "Preserve the original Request ID.", "schema": { "type": "string" } }, "X-Should-Retry": { "description": "false forbids automatic retry; unknown outcomes must be reconciled.", "schema": { "enum": [ "true", "false" ], "type": "string" } } } }, "504": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Public error classes: model_timeout.", "headers": { "Retry-After": { "description": "Wait the returned number of seconds before an allowed retry.", "schema": { "type": "string" } }, "X-Request-ID": { "description": "Preserve the original Request ID.", "schema": { "type": "string" } }, "X-Should-Retry": { "description": "false forbids automatic retry; unknown outcomes must be reconciled.", "schema": { "enum": [ "true", "false" ], "type": "string" } } } }, "5XX": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Response shape depends on the selected model and method.", "headers": { "X-Request-ID": { "description": "Preserve the original Request ID.", "schema": { "type": "string" } } } } }, "security": [ { "clientBearer": [] } ], "summary": "Generate content with the native protocol" } } }, "security": [ { "clientBearer": [] } ], "servers": [ { "url": "https://api.ailoot.ai" } ], "x-authentication": { "accepted_alternative_headers": [ "x-api-key", "x-goog-api-key" ], "forbidden_query_parameter": "api_key", "preferred": "Authorization: Bearer ${AILOOT_API_KEY}", "query_key": "Gemini compatibility accepts key with lowest priority; public examples use headers.", "realtime": "Bearer header only; query keys rejected" }, "x-contract-scope": { "models": "Discover exact current IDs and aliases through authenticated GET /v1/models. Examples preserve documented IDs; they are not a frozen catalogue.", "schema_completeness": "Documented required request fields and public response fields are captured. Additional model-specific fields remain permitted; unknown constraints are not invented." }, "x-example-redaction": "Published illustrative IDs and media links replaced by explicit placeholders; remaining included source fields unchanged.", "x-public-source-revisions": [ { "path": "docs/en/api/chat-completions/index.html", "sha256": "bba934a31473a76227cdcbb37528d148e4308be164891b358e966a9208c3a6d2", "url": "https://ailoot.ai/docs/en/api/chat-completions/" }, { "path": "docs/en/api/responses/index.html", "sha256": "73d44ed67cd4a2536f4c71d732acf3ff4d78d69ca9fa25bfcbd0ebd5a9f00b48", "url": "https://ailoot.ai/docs/en/api/responses/" }, { "path": "docs/en/api/messages/index.html", "sha256": "88788affb210a9fe6da9d2d900065c85f3858a237961698129e7dd8b8c658a0d", "url": "https://ailoot.ai/docs/en/api/messages/" }, { "path": "docs/en/api/embeddings/index.html", "sha256": "2217e9d08448f581d02e744d2ebed6fa07f9e99f9fad635dc3d9a40b4d7c4c69", "url": "https://ailoot.ai/docs/en/api/embeddings/" }, { "path": "docs/en/api/images/index.html", "sha256": "536c8b04eef480ef4ccdbd56bfc3a6c7ce31aa7e1429ff7f67dc998e7f653cc9", "url": "https://ailoot.ai/docs/en/api/images/" }, { "path": "docs/en/api/audio/index.html", "sha256": "02dcdc8a7b2ce45531ee73c18050280deca25b765baab07d449aa330633dd200", "url": "https://ailoot.ai/docs/en/api/audio/" }, { "path": "docs/en/api/video-music/index.html", "sha256": "bde3772e796199351dc1077c433eac7f77acbd657b1eb3079c2c3819fb51d2b2", "url": "https://ailoot.ai/docs/en/api/video-music/" }, { "path": "docs/en/api/systemone/index.html", "sha256": "bcfb5f2ac4fd6c86f23a97fd63f1514de410c7cee2804057218d0f1b81b666ea", "url": "https://ailoot.ai/docs/en/api/systemone/" }, { "path": "docs/en/api/gemini/index.html", "sha256": "b12dd84bb50ca0c308a87a62227b13554a8d48a902f4dcd38925ea27266301b3", "url": "https://ailoot.ai/docs/en/api/gemini/" }, { "path": "docs/en/api/models/index.html", "sha256": "5131c945417e0ea84fc4445e350e6593d2ab589b7f1c6c0148c6ada7cd6f0f47", "url": "https://ailoot.ai/docs/en/api/models/" }, { "path": "docs/en/errors/index.html", "sha256": "2438417fc6afd93b22500b5905fe5e8ed22b2c533c80a6720ea9b49fd48d7244", "url": "https://ailoot.ai/docs/en/errors/" } ], "x-retry-contract": { "gemini_no_auto_retry": "Non-retryable 5xx classes/result_pending_check use 409 ABORTED.", "headers": [ "X-Request-ID", "X-Should-Retry", "Retry-After" ], "unknown_result": "Preserve Request ID and read original outcome; do not replay creation." } }