{"openapi":"3.1.0","info":{"title":"GizStack AI Gateway","version":"29ce6f2d3559fad113ef781f9cc77b14a638a454","description":"Every model of the catalog behind one key: language, image, video, audio and 3D. A call is charged to the key's team."},"servers":[{"url":"https://gizstack.com"}],"paths":{"/v1/models":{"get":{"operationId":"models","summary":"The models of the catalog, with their kinds and prices.","security":[{"bearer":[]}],"responses":{"200":{"description":"The answer."},"default":{"description":"An error: {\"error\": {\"message\": …}}."}}}},"/v1/chat/completions":{"post":{"operationId":"chat","summary":"Ask a language model: a chat completion request (model, messages and its other fields); the answer is the completion object.","security":[{"bearer":[]}],"responses":{"200":{"description":"The answer; server-sent events when the request asks to stream."},"default":{"description":"An error: {\"error\": {\"message\": …}}."}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"model":{"type":"string","description":"The model id, from models."},"messages":{"type":"array","description":"The chat messages: role and content."}},"required":["model","messages"],"additionalProperties":true}}}}}},"/v1/responses":{"post":{"operationId":"responses","summary":"Ask a language model, or an Agent of the team as agent:ID, in the form of the Responses API.","security":[{"bearer":[]}],"responses":{"200":{"description":"The answer; server-sent events when the request asks to stream."},"default":{"description":"An error: {\"error\": {\"message\": …}}."}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"model":{"type":"string","description":"The model id, from models."},"input":{"type":"string","description":"The text, or the list of input items."}},"required":["model","input"],"additionalProperties":true}}}}}},"/v1/responses/{id}":{"get":{"operationId":"response","summary":"An Agent's turn that a response started.","security":[{"bearer":[]}],"responses":{"200":{"description":"The answer."},"default":{"description":"An error: {\"error\": {\"message\": …}}."}},"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}]}},"/v1/messages":{"post":{"operationId":"messages","summary":"Ask a language model in the form of the Messages API.","security":[{"bearer":[]}],"responses":{"200":{"description":"The answer; server-sent events when the request asks to stream."},"default":{"description":"An error: {\"error\": {\"message\": …}}."}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"model":{"type":"string","description":"The model id, from models."},"messages":{"type":"array","description":"The messages: role and content."},"max_tokens":{"type":"integer","description":"The most tokens of the answer."}},"required":["model","messages","max_tokens"],"additionalProperties":true}}}}}},"/v1/generations":{"post":{"operationId":"generate","summary":"Start a media generation (image, video, audio, speech or 3D): the model and its fields; wait (s) waits for it.","security":[{"bearer":[]}],"responses":{"200":{"description":"The answer."},"default":{"description":"An error: {\"error\": {\"message\": …}}."}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"model":{"type":"string","description":"The media model id, from models."},"wait":{"type":"integer","description":"Seconds to wait for the result."}},"required":["model"],"additionalProperties":true}}}}}},"/v1/tasks/{id}":{"get":{"operationId":"task","summary":"A generation's task: its state and outputs.","security":[{"bearer":[]}],"responses":{"200":{"description":"The answer."},"default":{"description":"An error: {\"error\": {\"message\": …}}."}},"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}]}},"/v1/images/generations":{"post":{"operationId":"images","summary":"Make pictures of a prompt, in the form of the Images API.","security":[{"bearer":[]}],"responses":{"200":{"description":"The answer."},"default":{"description":"An error: {\"error\": {\"message\": …}}."}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"model":{"type":"string","description":"The image model id, from models."},"prompt":{"type":"string","description":"What the picture shows."}},"required":["model","prompt"],"additionalProperties":true}}}}}},"/v1/audio/speech":{"post":{"operationId":"speech","summary":"Speak a text, in the form of the Audio API.","security":[{"bearer":[]}],"responses":{"200":{"description":"The answer."},"default":{"description":"An error: {\"error\": {\"message\": …}}."}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"model":{"type":"string","description":"The speech model id, from models."},"input":{"type":"string","description":"The text to speak."}},"required":["model","input"],"additionalProperties":true}}}}}},"/v1/audio/transcriptions":{"post":{"operationId":"transcriptions","summary":"Write what a recording says (a multipart form with its file).","security":[{"bearer":[]}],"responses":{"200":{"description":"The answer."},"default":{"description":"An error: {\"error\": {\"message\": …}}."}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"model":{"type":"string","description":"The transcription model id, from models."}},"required":["model"],"additionalProperties":true}}}}}},"/v1/embeddings":{"post":{"operationId":"embeddings","summary":"Turn texts into vectors, in the form of the Embeddings API.","security":[{"bearer":[]}],"responses":{"200":{"description":"The answer."},"default":{"description":"An error: {\"error\": {\"message\": …}}."}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"model":{"type":"string","description":"The embedding model id, from models."},"input":{"type":"string","description":"A text, or an array of texts."}},"required":["model","input"],"additionalProperties":true}}}}}},"/v1/rerank":{"post":{"operationId":"rerank","summary":"Order documents by how well each answers a query.","security":[{"bearer":[]}],"responses":{"200":{"description":"The answer."},"default":{"description":"An error: {\"error\": {\"message\": …}}."}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"model":{"type":"string","description":"The rerank model id, from models."},"query":{"type":"string","description":"The question."},"documents":{"type":"array","description":"The texts to order."},"top_n":{"type":"integer","description":"How many to return."}},"required":["model","query","documents"],"additionalProperties":true}}}}}},"/v1/files":{"post":{"operationId":"upload","summary":"Keep an input file (a picture, a video or a sound) in the team's Drive: ?name=cat.png, the file as the body. The answer's address is what a generation's file field takes; it ends in an hour.","security":[{"bearer":[]}],"responses":{"200":{"description":"The answer."},"default":{"description":"An error: {\"error\": {\"message\": …}}."}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string","description":"The file's name, with its extension (in the query)."}},"required":["name"],"additionalProperties":true}}}}}},"/v1/usage":{"get":{"operationId":"usage","summary":"What the key stands at: plan, windows, what its team can spend and its rules.","security":[{"bearer":[]}],"responses":{"200":{"description":"The answer."},"default":{"description":"An error: {\"error\": {\"message\": …}}."}}}}},"components":{"securitySchemes":{"bearer":{"type":"http","scheme":"bearer"}}}}