{"openapi":"3.1.0","info":{"title":"API429 Public API","version":"1.0","description":"Sanitized customer integration contract."},"servers":[{"url":"https://gateway.api429.com"}],"paths":{"/api/public/catalog":{"get":{"operationId":"getPublicCatalog","summary":"Get the published model catalog","responses":{"200":{"description":"Published catalog","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicCatalogResponse"}}}},"503":{"description":"Request error","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}}}}},"/api/public/openapi.json":{"get":{"operationId":"getPublicOpenApi","summary":"Get this sanitized OpenAPI document","responses":{"200":{"description":"OpenAPI document"}}}},"/v1/models":{"get":{"operationId":"listModels","summary":"List models available to the authenticated token","security":[{"BearerAuth":[]}],"responses":{"200":{"description":"OpenAI-compatible model list"}}}},"/v1/chat/completions":{"post":{"operationId":"createChatCompletion","summary":"Create a chat completion","security":[{"BearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["model","messages"],"properties":{"model":{"type":"string","description":"Use an ID returned by GET /v1/models with your key."},"messages":{"type":"array","minItems":1,"items":{"type":"object","required":["role","content"],"properties":{"role":{"type":"string","enum":["system","user","assistant","tool"]},"content":{"oneOf":[{"type":"string"},{"type":"array","items":{"type":"object"}}]}}}},"max_tokens":{"type":"integer","minimum":1},"stream":{"type":"boolean","default":false}},"additionalProperties":true},"example":{"model":"gemini-3.8-flash","messages":[{"role":"user","content":"Explain what an API is in one sentence."}],"max_tokens":256,"stream":false}}}},"responses":{"200":{"description":"Chat completion"}}}},"/v1/responses":{"post":{"operationId":"createResponse","summary":"Create a Responses API response","security":[{"BearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["model","input"],"properties":{"model":{"type":"string","description":"Use an ID returned by GET /v1/models with your key."},"input":{"type":"string"}},"additionalProperties":true},"example":{"model":"gpt-6-astra","input":"Reply with a short greeting.","max_output_tokens":256}}}},"responses":{"200":{"description":"Response"}}}},"/v1/images/generations":{"post":{"operationId":"createImage","summary":"Generate an image","security":[{"BearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["model","prompt"],"properties":{"model":{"type":"string","description":"Use an ID returned by GET /v1/models with your key."},"prompt":{"type":"string"},"n":{"type":"integer","minimum":1},"size":{"type":"string"},"response_format":{"type":"string","enum":["b64_json","url"]}},"additionalProperties":true},"example":{"model":"gemini-3.1-flash-image","prompt":"A mountain landscape at sunrise, no text","n":1,"size":"1024x1024","response_format":"b64_json"}}}},"responses":{"200":{"description":"Generated image"}}}},"/v1/images/edits":{"post":{"operationId":"editImage","summary":"Edit an image","security":[{"BearerAuth":[]}],"requestBody":{"required":true,"content":{"multipart/form-data":{"schema":{"type":"object","required":["prompt","image"],"properties":{"model":{"type":"string"},"prompt":{"type":"string"},"image":{"type":"array","items":{"type":"string","format":"binary"}},"mask":{"type":"string","format":"binary"},"size":{"type":"string"},"quality":{"type":"string"},"n":{"type":"integer","minimum":1}}}}}},"responses":{"200":{"description":"Edited image"}}}},"/v1/embeddings":{"post":{"operationId":"createEmbedding","summary":"Create embeddings","security":[{"BearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["model","input"],"properties":{"model":{"type":"string","description":"Use an ID returned by GET /v1/models with your key."},"input":{"oneOf":[{"type":"string"},{"type":"array","items":{"type":"string"}}]}},"additionalProperties":true},"example":{"model":"gemini-embedding-001","input":"An example document"}}}},"responses":{"200":{"description":"Embeddings"}}}},"/v1/audio/speech":{"post":{"operationId":"createSpeech","summary":"Synthesize speech","security":[{"BearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["model","input"],"properties":{"model":{"type":"string","description":"Use an ID returned by GET /v1/models with your key."},"input":{"type":"string"},"voice":{"type":"string"},"response_format":{"type":"string"}},"additionalProperties":true},"example":{"model":"elevenlabs-gen","input":"Hello from API429.","response_format":"mp3"}}}},"responses":{"200":{"description":"Audio stream"}}}},"/api/client/balance":{"get":{"operationId":"getBalance","summary":"Get the authenticated token balance","security":[{"BearerAuth":[]}],"responses":{"200":{"description":"Balance"}}}}},"components":{"securitySchemes":{"BearerAuth":{"type":"http","scheme":"bearer"}},"schemas":{"PublicCatalogResponse":{"additionalProperties":false,"properties":{"schema_version":{"const":"1.0","default":"1.0","title":"Schema Version","type":"string"},"generated_at":{"format":"date-time","title":"Generated At","type":"string"},"count":{"minimum":0,"title":"Count","type":"integer"},"models":{"items":{"$ref":"#/components/schemas/PublicCatalogModel"},"title":"Models","type":"array"}},"required":["generated_at","count","models"],"title":"PublicCatalogResponse","type":"object"},"PublicCatalogModel":{"additionalProperties":false,"properties":{"id":{"maxLength":200,"minLength":1,"title":"Id","type":"string"},"display_name":{"maxLength":200,"minLength":1,"title":"Display Name","type":"string"},"vendor":{"enum":["google","openai","anthropic","xai","elevenlabs","api429"],"title":"Vendor","type":"string"},"category":{"enum":["text","image","video","audio","embedding"],"title":"Category","type":"string"},"lifecycle":{"enum":["stable","preview"],"title":"Lifecycle","type":"string"},"availability":{"const":"published","default":"published","title":"Availability","type":"string"},"capabilities":{"items":{"type":"string"},"title":"Capabilities","type":"array"},"pricing":{"$ref":"#/components/schemas/PublicCatalogPricing"}},"required":["id","display_name","vendor","category","lifecycle","capabilities","pricing"],"title":"PublicCatalogModel","type":"object"},"PublicCatalogPricing":{"additionalProperties":false,"properties":{"currency":{"const":"USD","default":"USD","title":"Currency","type":"string"},"scope":{"const":"standard_public","default":"standard_public","title":"Scope","type":"string"},"kind":{"enum":["rate_card","variable"],"title":"Kind","type":"string"},"rates":{"items":{"$ref":"#/components/schemas/PublicCatalogRate"},"title":"Rates","type":"array"}},"required":["kind","rates"],"title":"PublicCatalogPricing","type":"object"},"PublicCatalogRate":{"additionalProperties":false,"properties":{"metric":{"enum":["input_tokens","cached_input_tokens","cache_write_input_tokens","output_tokens","image","tts_characters","web_search_calls","video_second","video_clip","music_track"],"title":"Metric","type":"string"},"per":{"exclusiveMinimum":0,"title":"Per","type":"integer"},"amount":{"pattern":"^(?:0|[1-9][0-9]*)(?:\\.[0-9]+)?$","title":"Amount","type":"string"},"condition":{"anyOf":[{"maxLength":120,"type":"string"},{"type":"null"}],"default":null,"title":"Condition"}},"required":["metric","per","amount"],"title":"PublicCatalogRate","type":"object"}}}}