{"components":{"schemas":{"Error":{"properties":{"error":{"properties":{"code":{"type":"string"},"message":{"type":"string"},"type":{"const":"mizar_error","type":"string"}},"type":"object"}},"type":"object"}},"securitySchemes":{"bearerAuth":{"description":"API key created in the console /keys page; send as Authorization: Bearer \u003ckey\u003e","scheme":"bearer","type":"http"}}},"info":{"description":"OpenAI-compatible AI API relay. Auth: Bearer API key created in the console /keys page. Public docs: /llms.txt, /api/pricing.","title":"开阳 Mizar API","version":"1.0"},"openapi":"3.1.0","paths":{"/api/pricing":{"get":{"responses":{"200":{"content":{"application/json":{"schema":{"additionalProperties":true,"type":"object"}}},"description":"Per-model pricing; see /llms.txt for ratio conversion"},"5XX":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Server error"}},"security":[],"summary":"Public pricing table (newapi-compatible ratios)"}},"/api/site-info":{"get":{"responses":{"200":{"content":{"application/json":{"schema":{"additionalProperties":true,"type":"object"}}},"description":"Site brand name"},"5XX":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Server error"}},"security":[],"summary":"Site info: brand name"}},"/mj/insight-face/swap":{"post":{"requestBody":{"content":{"application/json":{"schema":{"additionalProperties":true,"type":"object"}}},"description":"Face swap body with source/target image URLs","required":true},"responses":{"200":{"content":{"application/json":{"schema":{"additionalProperties":true,"type":"object"}}},"description":"Success"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Missing or invalid API key (Authorization: Bearer \u003ckey\u003e)"},"402":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Insufficient balance (prepaid credits)"},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Rate limited (key RPM/TPM or auth limiter)"},"5XX":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Upstream or server error"}},"summary":"Midjourney face swap (insight-face)"}},"/mj/submit/{command}":{"post":{"parameters":[{"description":"Midjourney command verb: imagine|upscale|variation|reroll|blend|describe|modal|video|edit|shorten...","in":"path","name":"command","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"additionalProperties":true,"type":"object"}}},"description":"Midjourney task envelope; result carries the job id for polling"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Missing or invalid API key (Authorization: Bearer \u003ckey\u003e)"},"402":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Insufficient balance (prepaid credits)"},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Rate limited (key RPM/TPM or auth limiter)"},"5XX":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Upstream or server error"}},"summary":"Midjourney native submit (imagine/upscale/variation/reroll/blend/describe/modal/video/edit...)"}},"/mj/task/url/refresh":{"post":{"requestBody":{"content":{"application/json":{"schema":{"additionalProperties":true,"type":"object"}}},"description":"Body carries the task/result URL to refresh","required":true},"responses":{"200":{"content":{"application/json":{"schema":{"additionalProperties":true,"type":"object"}}},"description":"Success"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Missing or invalid API key (Authorization: Bearer \u003ckey\u003e)"},"402":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Insufficient balance (prepaid credits)"},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Rate limited (key RPM/TPM or auth limiter)"},"5XX":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Upstream or server error"}},"summary":"Refresh Midjourney task image URL (re-CDN)"}},"/mj/task/{id}/fetch":{"get":{"parameters":[{"description":"Midjourney task id","in":"path","name":"id","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"additionalProperties":true,"type":"object"}}},"description":"Task status envelope"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Missing or invalid API key (Authorization: Bearer \u003ckey\u003e)"},"402":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Insufficient balance (prepaid credits)"},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Rate limited (key RPM/TPM or auth limiter)"},"5XX":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Upstream or server error"}},"summary":"Fetch Midjourney task status by native task id"}},"/mj/task/{id}/image":{"get":{"parameters":[{"description":"Midjourney task id","in":"path","name":"id","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"image/*":{"schema":{"format":"binary","type":"string"}}},"description":"302 redirect to the image"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Missing or invalid API key (Authorization: Bearer \u003ckey\u003e)"},"402":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Insufficient balance (prepaid credits)"},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Rate limited (key RPM/TPM or auth limiter)"},"5XX":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Upstream or server error"}},"summary":"Get Midjourney task image (302 to archived asset or CDN URL)"}},"/openapi.json":{"get":{"responses":{"200":{"content":{"application/json":{"schema":{"additionalProperties":true,"type":"object"}}},"description":"OpenAPI 3.1 document"},"5XX":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Server error"}},"security":[],"summary":"This OpenAPI document"}},"/v1/chat/completions":{"post":{"requestBody":{"content":{"application/json":{"schema":{"additionalProperties":true,"properties":{"model":{"description":"Model name; see GET /v1/models or GET /api/pricing","type":"string"}},"required":["model"],"type":"object"}}},"description":"OpenAI chat completion request body; set stream=true for SSE streaming","required":true},"responses":{"200":{"content":{"application/json":{"schema":{"additionalProperties":true,"type":"object"}}},"description":"Success (OpenAI-compatible response object)"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Missing or invalid API key (Authorization: Bearer \u003ckey\u003e)"},"402":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Insufficient balance (prepaid credits)"},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Rate limited (key RPM/TPM or auth limiter)"},"5XX":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Upstream or server error"}},"summary":"Create a chat completion (supports stream=true, SSE)"}},"/v1/cost-estimate":{"post":{"requestBody":{"content":{"application/json":{"schema":{"additionalProperties":true,"properties":{"model":{"description":"Model name; see GET /v1/models or GET /api/pricing","type":"string"}},"required":["model"],"type":"object"}}},"description":"Target endpoint request plus declared usage; returns estimated credits. Read-only, shares key rate limits with /v1","required":true},"responses":{"200":{"content":{"application/json":{"schema":{"additionalProperties":true,"type":"object"}}},"description":"Success (OpenAI-compatible response object)"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Missing or invalid API key (Authorization: Bearer \u003ckey\u003e)"},"402":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Insufficient balance (prepaid credits)"},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Rate limited (key RPM/TPM or auth limiter)"},"5XX":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Upstream or server error"}},"summary":"Estimate cost before submitting (no billing, no ledger)"}},"/v1/embeddings":{"post":{"requestBody":{"content":{"application/json":{"schema":{"additionalProperties":true,"properties":{"model":{"description":"Model name; see GET /v1/models or GET /api/pricing","type":"string"}},"required":["model"],"type":"object"}}},"description":"OpenAI embeddings request body (input, model)","required":true},"responses":{"200":{"content":{"application/json":{"schema":{"additionalProperties":true,"type":"object"}}},"description":"Success (OpenAI-compatible response object)"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Missing or invalid API key (Authorization: Bearer \u003ckey\u003e)"},"402":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Insufficient balance (prepaid credits)"},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Rate limited (key RPM/TPM or auth limiter)"},"5XX":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Upstream or server error"}},"summary":"Create embeddings"}},"/v1/image-batches/edits":{"post":{"requestBody":{"content":{"application/json":{"schema":{"additionalProperties":true,"properties":{"model":{"description":"Model name; see GET /v1/models or GET /api/pricing","type":"string"}},"required":["model"],"type":"object"}}},"description":"Image batch edit body; image URLs must be publicly fetchable, count\u003e1 splits tasks","required":true},"responses":{"200":{"content":{"application/json":{"schema":{"additionalProperties":true,"type":"object"}}},"description":"Success (OpenAI-compatible response object)"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Missing or invalid API key (Authorization: Bearer \u003ckey\u003e)"},"402":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Insufficient balance (prepaid credits)"},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Rate limited (key RPM/TPM or auth limiter)"},"5XX":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Upstream or server error"}},"summary":"Submit an async image batch edit (public image URLs)"}},"/v1/image-batches/generations":{"post":{"requestBody":{"content":{"application/json":{"schema":{"additionalProperties":true,"properties":{"model":{"description":"Model name; see GET /v1/models or GET /api/pricing","type":"string"}},"required":["model"],"type":"object"}}},"description":"Image batch request body (model, prompt, n\u003c=1000); Idempotency-Key header honored; poll GET /v1/image-batches/{id}","required":true},"responses":{"200":{"content":{"application/json":{"schema":{"additionalProperties":true,"type":"object"}}},"description":"Success (OpenAI-compatible response object)"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Missing or invalid API key (Authorization: Bearer \u003ckey\u003e)"},"402":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Insufficient balance (prepaid credits)"},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Rate limited (key RPM/TPM or auth limiter)"},"5XX":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Upstream or server error"}},"summary":"Submit an async image batch generation (up to 1000 images)"}},"/v1/image-batches/{id}":{"get":{"parameters":[{"description":"Batch ID returned by POST /v1/image-batches/*","in":"path","name":"id","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"additionalProperties":true,"type":"object"}}},"description":"Batch status with per-image items; billing is per actually delivered image"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Missing or invalid API key (Authorization: Bearer \u003ckey\u003e)"},"402":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Insufficient balance (prepaid credits)"},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Rate limited (key RPM/TPM or auth limiter)"},"5XX":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Upstream or server error"}},"summary":"Get image batch status and delivered images"}},"/v1/images/edits":{"post":{"requestBody":{"content":{"application/json":{"schema":{"additionalProperties":true,"properties":{"model":{"description":"Model name; see GET /v1/models or GET /api/pricing","type":"string"}},"required":["model"],"type":"object"}}},"description":"OpenAI image edit; accepted as multipart/form-data (with image file) or JSON","required":true},"responses":{"200":{"content":{"application/json":{"schema":{"additionalProperties":true,"type":"object"}}},"description":"Success (OpenAI-compatible response object)"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Missing or invalid API key (Authorization: Bearer \u003ckey\u003e)"},"402":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Insufficient balance (prepaid credits)"},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Rate limited (key RPM/TPM or auth limiter)"},"5XX":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Upstream or server error"}},"summary":"Edit an image"}},"/v1/images/generations":{"post":{"requestBody":{"content":{"application/json":{"schema":{"additionalProperties":true,"properties":{"model":{"description":"Model name; see GET /v1/models or GET /api/pricing","type":"string"}},"required":["model"],"type":"object"}}},"description":"OpenAI image generation request body; model names starting with mj- route to Midjourney","required":true},"responses":{"200":{"content":{"application/json":{"schema":{"additionalProperties":true,"type":"object"}}},"description":"Success (OpenAI-compatible response object)"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Missing or invalid API key (Authorization: Bearer \u003ckey\u003e)"},"402":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Insufficient balance (prepaid credits)"},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Rate limited (key RPM/TPM or auth limiter)"},"5XX":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Upstream or server error"}},"summary":"Generate images from a text prompt"}},"/v1/images/generations/{id}":{"get":{"parameters":[{"description":"Image job ID returned by POST /v1/images/generations (mj-* or async models)","in":"path","name":"id","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"additionalProperties":true,"type":"object"}}},"description":"Image job status object; completed jobs include image URLs"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Missing or invalid API key (Authorization: Bearer \u003ckey\u003e)"},"402":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Insufficient balance (prepaid credits)"},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Rate limited (key RPM/TPM or auth limiter)"},"5XX":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Upstream or server error"}},"summary":"Get async image job status (Midjourney / async image tracks)"}},"/v1/models":{"get":{"responses":{"200":{"content":{"application/json":{"schema":{"additionalProperties":true,"type":"object"}}},"description":"OpenAI-compatible model list object"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Missing or invalid API key (Authorization: Bearer \u003ckey\u003e)"},"402":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Insufficient balance (prepaid credits)"},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Rate limited (key RPM/TPM or auth limiter)"},"5XX":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Upstream or server error"}},"summary":"List available models"}},"/v1/moderations":{"post":{"requestBody":{"content":{"application/json":{"schema":{"additionalProperties":true,"properties":{"model":{"description":"Model name; see GET /v1/models or GET /api/pricing","type":"string"}},"required":["model"],"type":"object"}}},"description":"OpenAI moderations request body (input, model)","required":true},"responses":{"200":{"content":{"application/json":{"schema":{"additionalProperties":true,"type":"object"}}},"description":"Success (OpenAI-compatible response object)"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Missing or invalid API key (Authorization: Bearer \u003ckey\u003e)"},"402":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Insufficient balance (prepaid credits)"},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Rate limited (key RPM/TPM or auth limiter)"},"5XX":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Upstream or server error"}},"summary":"Moderate text"}},"/v1/rerank":{"post":{"requestBody":{"content":{"application/json":{"schema":{"additionalProperties":true,"properties":{"model":{"description":"Model name; see GET /v1/models or GET /api/pricing","type":"string"}},"required":["model"],"type":"object"}}},"description":"Rerank request body (query, documents, model)","required":true},"responses":{"200":{"content":{"application/json":{"schema":{"additionalProperties":true,"type":"object"}}},"description":"Success (OpenAI-compatible response object)"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Missing or invalid API key (Authorization: Bearer \u003ckey\u003e)"},"402":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Insufficient balance (prepaid credits)"},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Rate limited (key RPM/TPM or auth limiter)"},"5XX":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Upstream or server error"}},"summary":"Rerank documents by relevance to a query"}},"/v1/responses":{"post":{"requestBody":{"content":{"application/json":{"schema":{"additionalProperties":true,"properties":{"model":{"description":"Model name; see GET /v1/models or GET /api/pricing","type":"string"}},"required":["model"],"type":"object"}}},"description":"OpenAI Responses API request body; supports streaming","required":true},"responses":{"200":{"content":{"application/json":{"schema":{"additionalProperties":true,"type":"object"}}},"description":"Success (OpenAI-compatible response object)"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Missing or invalid API key (Authorization: Bearer \u003ckey\u003e)"},"402":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Insufficient balance (prepaid credits)"},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Rate limited (key RPM/TPM or auth limiter)"},"5XX":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Upstream or server error"}},"summary":"Create a response (OpenAI Responses API)"}},"/v1/videos":{"post":{"requestBody":{"content":{"application/json":{"schema":{"additionalProperties":true,"properties":{"model":{"description":"Model name; see GET /v1/models or GET /api/pricing","type":"string"}},"required":["model"],"type":"object"}}},"description":"Video generation request body; returns a job id, poll GET /v1/videos/{id}","required":true},"responses":{"200":{"content":{"application/json":{"schema":{"additionalProperties":true,"type":"object"}}},"description":"Success (OpenAI-compatible response object)"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Missing or invalid API key (Authorization: Bearer \u003ckey\u003e)"},"402":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Insufficient balance (prepaid credits)"},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Rate limited (key RPM/TPM or auth limiter)"},"5XX":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Upstream or server error"}},"summary":"Submit an async video generation job"}},"/v1/videos/{id}":{"delete":{"parameters":[{"description":"Video job ID returned by POST /v1/videos","in":"path","name":"id","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"additionalProperties":true,"type":"object"}}},"description":"Deletion result object"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Missing or invalid API key (Authorization: Bearer \u003ckey\u003e)"},"402":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Insufficient balance (prepaid credits)"},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Rate limited (key RPM/TPM or auth limiter)"},"5XX":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Upstream or server error"}},"summary":"Delete a video job"},"get":{"parameters":[{"description":"Video job ID returned by POST /v1/videos","in":"path","name":"id","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"additionalProperties":true,"type":"object"}}},"description":"Video job status object"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Missing or invalid API key (Authorization: Bearer \u003ckey\u003e)"},"402":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Insufficient balance (prepaid credits)"},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Rate limited (key RPM/TPM or auth limiter)"},"5XX":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Upstream or server error"}},"summary":"Get video job status"}},"/v1/videos/{id}/content":{"get":{"parameters":[{"description":"Video job ID returned by POST /v1/videos","in":"path","name":"id","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/octet-stream":{"schema":{"format":"binary","type":"string"}}},"description":"Video binary content"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Missing or invalid API key (Authorization: Bearer \u003ckey\u003e)"},"402":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Insufficient balance (prepaid credits)"},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Rate limited (key RPM/TPM or auth limiter)"},"5XX":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Upstream or server error"}},"summary":"Download video content (binary)"}},"/v1beta/interactions":{"post":{"requestBody":{"content":{"application/json":{"schema":{"additionalProperties":true,"properties":{"model":{"description":"Model name; see GET /v1/models or GET /api/pricing","type":"string"}},"required":["model"],"type":"object"}}},"description":"Interaction request body (model in body); returns a job id, poll GET /v1beta/interactions/{id}","required":true},"responses":{"200":{"content":{"application/json":{"schema":{"additionalProperties":true,"type":"object"}}},"description":"Success (OpenAI-compatible response object)"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Missing or invalid API key (Authorization: Bearer \u003ckey\u003e)"},"402":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Insufficient balance (prepaid credits)"},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Rate limited (key RPM/TPM or auth limiter)"},"5XX":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Upstream or server error"}},"summary":"Create an interaction (background-jobs style native API)"}},"/v1beta/interactions/{id}":{"delete":{"parameters":[{"description":"Interaction job ID","in":"path","name":"id","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"additionalProperties":true,"type":"object"}}},"description":"Deletion result object"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Missing or invalid API key (Authorization: Bearer \u003ckey\u003e)"},"402":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Insufficient balance (prepaid credits)"},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Rate limited (key RPM/TPM or auth limiter)"},"5XX":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Upstream or server error"}},"summary":"Delete an interaction"},"get":{"parameters":[{"description":"Interaction job ID","in":"path","name":"id","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"additionalProperties":true,"type":"object"}}},"description":"Interaction status object"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Missing or invalid API key (Authorization: Bearer \u003ckey\u003e)"},"402":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Insufficient balance (prepaid credits)"},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Rate limited (key RPM/TPM or auth limiter)"},"5XX":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Upstream or server error"}},"summary":"Get interaction status/result"}},"/v1beta/models":{"get":{"responses":{"200":{"content":{"application/json":{"schema":{"additionalProperties":true,"type":"object"}}},"description":"Gemini-shaped model list"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Missing or invalid API key (Authorization: Bearer \u003ckey\u003e)"},"402":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Insufficient balance (prepaid credits)"},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Rate limited (key RPM/TPM or auth limiter)"},"5XX":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Upstream or server error"}},"summary":"List models (Gemini native API shape)"}},"/v1beta/models/{modelAction}":{"post":{"parameters":[{"description":"Model id + colon + action, e.g. gemini-2.5-pro:generateContent","in":"path","name":"modelAction","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"additionalProperties":true,"type":"object"}}},"description":"Gemini native response; streamGenerateContent returns SSE; countTokens is a non-billed passthrough"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Missing or invalid API key (Authorization: Bearer \u003ckey\u003e)"},"402":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Insufficient balance (prepaid credits)"},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Rate limited (key RPM/TPM or auth limiter)"},"5XX":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Upstream or server error"}},"summary":"Gemini native endpoint (generateContent / streamGenerateContent / countTokens)"}}},"security":[{"bearerAuth":[]}]}