{ "openapi": "3.1.0", "info": { "title": "SimpleLLM public V1 API", "version": "1.0.0", "description": "OpenAI-compatible production API. Model capabilities and availability vary. Account/admin session APIs, the unofficial Anthropic adapter, and V3-only endpoints are outside this contract." }, "servers": [ { "url": "https://api.simplellm.eu" } ], "externalDocs": { "url": "https://simplellm.eu/docs/", "description": "Static API documentation and examples" }, "security": [ { "bearerAuth": [] } ], "paths": { "/v1/models": { "get": { "operationId": "listModels", "summary": "List model IDs", "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Models" } } } }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "402": { "description": "Insufficient credits", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "Access denied", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Model or resource not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "Rate or capacity limit", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "500": { "description": "Internal error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "502": { "description": "Routing or upstream error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "503": { "description": "Temporarily unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "504": { "description": "Deployment timeout", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/v1/chat/completions": { "post": { "operationId": "createChatCompletion", "summary": "Create a chat completion", "responses": { "200": { "description": "JSON response or incremental SSE stream ending with data: [DONE].", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ChatResponse" } }, "text/event-stream": { "schema": { "type": "string" }, "example": "data: {\"choices\":[{\"delta\":{\"content\":\"Hello\"}}]}\n\ndata: [DONE]\n\n" } } }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "402": { "description": "Insufficient credits", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "Access denied", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Model or resource not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "Rate or capacity limit", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "500": { "description": "Internal error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "502": { "description": "Routing or upstream error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "503": { "description": "Temporarily unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "504": { "description": "Deployment timeout", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "description": "Model-specific vision and tool support. stream=true returns SSE; usage-only events may have empty choices. Client cancellation closes the upstream connection. Cancelled streams with zero recorded output tokens are not charged; partial usage after output may be estimated and billed. No automatic retry after response starts.", "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ChatRequest" } } } } } }, "/v1/completions": { "post": { "operationId": "legacyCompletions", "summary": "Not implemented in V1", "deprecated": true, "description": "Use POST /v1/chat/completions instead.", "responses": { "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "402": { "description": "Insufficient credits", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "Access denied", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Model or resource not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "Rate or capacity limit", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "500": { "description": "Internal error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "501": { "description": "Not implemented", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "502": { "description": "Routing or upstream error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "503": { "description": "Temporarily unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "504": { "description": "Deployment timeout", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/v1/audio/speech": { "post": { "operationId": "createSpeech", "summary": "Generate speech audio", "responses": { "200": { "description": "Audio bytes in the requested format.", "content": { "audio/mpeg": { "schema": { "type": "string", "format": "binary" } }, "audio/opus": { "schema": { "type": "string", "format": "binary" } }, "audio/aac": { "schema": { "type": "string", "format": "binary" } }, "audio/flac": { "schema": { "type": "string", "format": "binary" } }, "audio/wav": { "schema": { "type": "string", "format": "binary" } }, "audio/pcm": { "schema": { "type": "string", "format": "binary" } } } }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "402": { "description": "Insufficient credits", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "Access denied", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Model or resource not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "Rate or capacity limit", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "500": { "description": "Internal error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "502": { "description": "Routing or upstream error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "503": { "description": "Temporarily unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "504": { "description": "Deployment timeout", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SpeechRequest" } } } } } }, "/v1/audio/transcriptions": { "post": { "operationId": "createTranscription", "summary": "Transcribe an uploaded audio file", "responses": { "200": { "description": "Transcription in the requested upstream-supported format.", "content": { "application/json": { "schema": { "type": "object", "properties": { "text": { "type": "string" } }, "required": [], "additionalProperties": true } }, "text/plain": { "schema": { "type": "string" } }, "text/vtt": { "schema": { "type": "string" } } } }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "402": { "description": "Insufficient credits", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "Access denied", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Model or resource not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "Rate or capacity limit", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "500": { "description": "Internal error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "502": { "description": "Routing or upstream error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "503": { "description": "Temporarily unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "504": { "description": "Deployment timeout", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "requestBody": { "required": true, "content": { "multipart/form-data": { "schema": { "$ref": "#/components/schemas/TranscriptionRequest" } } } } } }, "/v1/images/generations": { "post": { "operationId": "createImage", "summary": "Generate images", "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "properties": { "created": { "type": "integer" }, "data": { "type": "array", "items": { "type": "object", "properties": { "url": { "type": "string" }, "b64_json": { "type": "string" } }, "required": [], "additionalProperties": true } } }, "required": [], "additionalProperties": true } } } }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "402": { "description": "Insufficient credits", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "Access denied", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Model or resource not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "Rate or capacity limit", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "500": { "description": "Internal error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "502": { "description": "Routing or upstream error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "503": { "description": "Temporarily unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "504": { "description": "Deployment timeout", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ImageRequest" } } } } } }, "/v1/rate-limit": { "get": { "operationId": "getRateLimit", "summary": "Read rate-limit status", "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RateLimit" } } } }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "402": { "description": "Insufficient credits", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "Access denied", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Model or resource not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "Rate or capacity limit", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "500": { "description": "Internal error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "502": { "description": "Routing or upstream error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "503": { "description": "Temporarily unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "504": { "description": "Deployment timeout", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "description": "General minute request and free-model hourly/daily counters. Does not enumerate all key, model or upstream limits." } }, "/v1/usage": { "get": { "operationId": "getUsage", "summary": "Read account usage and balance", "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "properties": { "usage": { "type": "array", "items": { "$ref": "#/components/schemas/AccountDailyUsage" } }, "balance": { "type": "number" }, "total_spent": { "type": "number" } }, "required": [], "additionalProperties": true } } } }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "402": { "description": "Insufficient credits", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "Access denied", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Model or resource not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "Rate or capacity limit", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "500": { "description": "Internal error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "502": { "description": "Routing or upstream error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "503": { "description": "Temporarily unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "504": { "description": "Deployment timeout", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "description": "Daily usage for the last 30 days, current balance and lifetime total_spent in SC. This route has no date or granularity query filters." } }, "/v1/keys/": { "get": { "operationId": "listKeys", "summary": "List account API keys", "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "properties": { "api_keys": { "type": "array", "items": { "$ref": "#/components/schemas/APIKey" } } }, "required": [], "additionalProperties": true } } } }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "402": { "description": "Insufficient credits", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "Access denied", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Model or resource not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "Rate or capacity limit", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "500": { "description": "Internal error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "502": { "description": "Routing or upstream error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "503": { "description": "Temporarily unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "504": { "description": "Deployment timeout", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/v1/keys/current": { "get": { "operationId": "getCurrentKey", "summary": "Read current key metadata", "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/APIKey" } } } }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "402": { "description": "Insufficient credits", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "Access denied", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Model or resource not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "Rate or capacity limit", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "500": { "description": "Internal error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "502": { "description": "Routing or upstream error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "503": { "description": "Temporarily unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "504": { "description": "Deployment timeout", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/v1/keys/current/usage": { "get": { "operationId": "getCurrentKeyUsage", "summary": "Read current key usage", "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/KeyUsage" } } } }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "402": { "description": "Insufficient credits", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "Access denied", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Model or resource not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "Rate or capacity limit", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "500": { "description": "Internal error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "502": { "description": "Routing or upstream error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "503": { "description": "Temporarily unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "504": { "description": "Deployment timeout", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/v1/keys/current/usage/daily": { "get": { "operationId": "getCurrentKeyDailyUsage", "summary": "Read current key daily usage", "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "properties": { "usage": { "type": "array", "items": { "$ref": "#/components/schemas/KeyDailyUsage" } } }, "required": [], "additionalProperties": true } } } }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "402": { "description": "Insufficient credits", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "Access denied", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Model or resource not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "Rate or capacity limit", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "500": { "description": "Internal error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "502": { "description": "Routing or upstream error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "503": { "description": "Temporarily unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "504": { "description": "Deployment timeout", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/v1/keys/{keyID}/usage": { "get": { "operationId": "getKeyUsage", "summary": "Read usage for an owned key", "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/KeyUsage" } } } }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "402": { "description": "Insufficient credits", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "Access denied", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Model or resource not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "Rate or capacity limit", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "500": { "description": "Internal error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "502": { "description": "Routing or upstream error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "503": { "description": "Temporarily unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "504": { "description": "Deployment timeout", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "parameters": [ { "name": "keyID", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid" } } ] } }, "/v1/keys/{keyID}/usage/daily": { "get": { "operationId": "getKeyDailyUsage", "summary": "Read daily usage for an owned key", "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "properties": { "usage": { "type": "array", "items": { "$ref": "#/components/schemas/KeyDailyUsage" } } }, "required": [], "additionalProperties": true } } } }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "402": { "description": "Insufficient credits", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "Access denied", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Model or resource not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "Rate or capacity limit", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "500": { "description": "Internal error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "502": { "description": "Routing or upstream error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "503": { "description": "Temporarily unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "504": { "description": "Deployment timeout", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "parameters": [ { "name": "keyID", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid" } } ] } } }, "components": { "securitySchemes": { "bearerAuth": { "type": "http", "scheme": "bearer", "description": "SimpleLLM API key" } }, "schemas": { "Error": { "type": "object", "properties": { "error": { "type": "object", "properties": { "message": { "type": "string" }, "type": { "type": "string" }, "code": { "type": "string" } }, "required": [], "additionalProperties": true } }, "required": [ "error" ], "additionalProperties": true }, "ContentPart": { "type": "object", "properties": { "type": { "type": "string" }, "text": { "type": "string" }, "image_url": { "type": "object", "properties": { "url": { "type": "string" }, "detail": { "type": "string", "enum": [ "auto", "low", "high" ] } }, "required": [ "url" ], "additionalProperties": true } }, "required": [ "type" ], "additionalProperties": true }, "ToolCall": { "type": "object", "properties": { "id": { "type": "string" }, "type": { "const": "function" }, "function": { "type": "object", "properties": { "name": { "type": "string" }, "arguments": { "type": "string", "description": "JSON-encoded arguments; parse and validate before executing." } }, "required": [ "name", "arguments" ], "additionalProperties": true } }, "required": [ "id", "type", "function" ], "additionalProperties": true }, "Tool": { "type": "object", "properties": { "type": { "const": "function" }, "function": { "type": "object", "properties": { "name": { "type": "string" }, "description": { "type": "string" }, "parameters": { "type": "object", "additionalProperties": true }, "strict": { "type": "boolean", "description": "Only where the selected model/backend supports strict schemas." } }, "required": [ "name" ], "additionalProperties": true } }, "required": [ "type", "function" ], "additionalProperties": true }, "Message": { "type": "object", "properties": { "role": { "type": "string", "enum": [ "system", "developer", "user", "assistant", "tool" ] }, "content": { "oneOf": [ { "type": "string" }, { "type": "null" }, { "type": "array", "items": { "$ref": "#/components/schemas/ContentPart" } } ] }, "name": { "type": "string" }, "tool_call_id": { "type": "string" }, "tool_calls": { "type": "array", "items": { "$ref": "#/components/schemas/ToolCall" } }, "reasoning_content": { "type": [ "string", "null" ], "description": "Optional provider-specific reasoning; not guaranteed." }, "reasoning": { "type": [ "string", "null" ], "description": "Alternative provider-specific reasoning field; not guaranteed." } }, "required": [ "role" ], "additionalProperties": true }, "ChatRequest": { "type": "object", "properties": { "model": { "type": "string", "description": "Exact chat model ID from GET /v1/models." }, "messages": { "type": "array", "items": { "$ref": "#/components/schemas/Message" }, "minItems": 1 }, "stream": { "type": "boolean", "default": false }, "max_tokens": { "type": "integer", "minimum": 1, "description": "Output budget; reasoning can consume this budget." }, "temperature": { "type": "number" }, "top_p": { "type": "number" }, "stream_options": { "type": "object", "properties": { "include_usage": { "type": "boolean" } }, "required": [], "additionalProperties": true }, "stop": { "type": "array", "items": { "type": "string" }, "description": "V1 accepts an array of strings, not a plain string." }, "n": { "type": "integer", "description": "Forwarded; multiple choices are model-dependent." }, "presence_penalty": { "type": "number", "description": "Model-dependent sampling parameter." }, "frequency_penalty": { "type": "number", "description": "Model-dependent sampling parameter." }, "tools": { "type": "array", "items": { "$ref": "#/components/schemas/Tool" } }, "tool_choice": { "oneOf": [ { "type": "string" }, { "type": "object", "additionalProperties": true } ] }, "response_format": { "type": "object", "additionalProperties": true, "description": "Forwarded, model-dependent output-format request; no universal JSON schema guarantee." } }, "required": [ "model", "messages" ], "additionalProperties": true }, "Usage": { "type": "object", "properties": { "prompt_tokens": { "type": "integer" }, "completion_tokens": { "type": "integer" }, "total_tokens": { "type": "integer" }, "prompt_tokens_details": { "type": "object", "properties": { "cached_tokens": { "type": "integer", "description": "Subset of prompt_tokens, not additional input." } }, "required": [], "additionalProperties": true } }, "required": [], "additionalProperties": true }, "ChatResponse": { "type": "object", "properties": { "id": { "type": "string" }, "object": { "type": "string" }, "created": { "type": "integer" }, "model": { "type": "string" }, "choices": { "type": "array", "items": { "type": "object", "properties": { "index": { "type": "integer" }, "message": { "$ref": "#/components/schemas/Message" }, "finish_reason": { "type": [ "string", "null" ] } }, "required": [], "additionalProperties": true } }, "usage": { "$ref": "#/components/schemas/Usage" } }, "required": [], "additionalProperties": true }, "Models": { "type": "object", "properties": { "object": { "const": "list" }, "data": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string" }, "object": { "type": "string" }, "created": { "type": "integer" }, "owned_by": { "type": "string" } }, "required": [], "additionalProperties": true } } }, "required": [ "data" ], "additionalProperties": true }, "APIKey": { "type": "object", "properties": { "id": { "type": "string", "format": "uuid" }, "user_id": { "type": "string", "format": "uuid" }, "key_prefix": { "type": "string", "description": "Public prefix only, never the key secret." }, "name": { "type": [ "string", "null" ] }, "rate_limit_rpm": { "type": [ "integer", "null" ] }, "rate_limit_tpm": { "type": [ "integer", "null" ] }, "max_concurrent": { "type": [ "integer", "null" ] }, "balance_enabled": { "type": "boolean" }, "balance_sc": { "type": "number" }, "balance_limit_sc": { "type": "number" }, "created_at": { "type": "string", "format": "date-time" }, "last_used_at": { "type": [ "string", "null" ], "format": "date-time" }, "revoked_at": { "type": [ "string", "null" ], "format": "date-time" } }, "required": [], "additionalProperties": true }, "KeyUsage": { "type": "object", "properties": { "total_requests": { "type": "integer" }, "total_tokens_in": { "type": "integer" }, "total_tokens_out": { "type": "integer" }, "total_cost_sc": { "type": "number" } }, "required": [], "additionalProperties": true }, "KeyDailyUsage": { "type": "object", "properties": { "date": { "type": "string" }, "total_requests": { "type": "integer" }, "total_tokens_in": { "type": "integer" }, "total_tokens_out": { "type": "integer" }, "total_cost_sc": { "type": "number" } }, "required": [], "additionalProperties": true }, "AccountDailyUsage": { "type": "object", "properties": { "user_id": { "type": "string", "format": "uuid" }, "date": { "type": "string", "format": "date-time" }, "model": { "type": "string" }, "requests": { "type": "integer" }, "tokens_in": { "type": "integer" }, "tokens_out": { "type": "integer" }, "tokens_cached": { "type": "integer" }, "cost_sc": { "type": "number" } }, "required": [], "additionalProperties": true }, "RateLimit": { "type": "object", "properties": { "limit_rpm": { "type": "integer", "description": "General minute request bucket." }, "used_rpm": { "type": "integer", "description": "General minute request bucket." }, "remaining_rpm": { "type": "integer", "description": "General minute request bucket." }, "limit_rph": { "type": "integer", "description": "Free-model rph bucket." }, "used_rph": { "type": "integer", "description": "Free-model rph bucket." }, "remaining_rph": { "type": "integer", "description": "Free-model rph bucket." }, "limit_rpd": { "type": "integer", "description": "Free-model rpd bucket." }, "used_rpd": { "type": "integer", "description": "Free-model rpd bucket." }, "remaining_rpd": { "type": "integer", "description": "Free-model rpd bucket." }, "limit_tph": { "type": "integer", "description": "Free-model tph bucket." }, "used_tph": { "type": "integer", "description": "Free-model tph bucket." }, "remaining_tph": { "type": "integer", "description": "Free-model tph bucket." }, "limit_tpd": { "type": "integer", "description": "Free-model tpd bucket." }, "used_tpd": { "type": "integer", "description": "Free-model tpd bucket." }, "remaining_tpd": { "type": "integer", "description": "Free-model tpd bucket." }, "reset_seconds": { "type": "integer", "description": "Minute-bucket reset only." }, "banned": { "type": "boolean" }, "banned_until": { "type": "string" } }, "required": [], "additionalProperties": true }, "SpeechRequest": { "type": "object", "properties": { "model": { "type": "string", "default": "tts-1" }, "input": { "type": "string", "minLength": 1, "description": "At most 4096 UTF-8 bytes (not Unicode characters)." }, "voice": { "type": "string", "default": "alloy", "enum": [ "alloy", "echo", "fable", "onyx", "nova", "shimmer" ] }, "response_format": { "type": "string", "default": "mp3", "enum": [ "mp3", "opus", "aac", "flac", "wav", "pcm" ] }, "speed": { "type": "number", "minimum": 0.25, "maximum": 4, "default": 1 } }, "required": [ "input" ], "additionalProperties": true }, "TranscriptionRequest": { "type": "object", "properties": { "file": { "type": "string", "format": "binary" }, "model": { "type": "string", "default": "whisper-1", "examples": [ "whisper-large-v3", "whisper-large-v3-turbo" ], "description": "Use whisper-large-v3 or whisper-large-v3-turbo. The compatibility alias whisper-1 maps to whisper-large-v3-turbo and is also the default; it is not a separate model.", "enum": [ "whisper-1", "whisper-large-v3", "whisper-large-v3-turbo" ] }, "language": { "type": "string" }, "prompt": { "type": "string" }, "response_format": { "type": "string" }, "temperature": { "type": "number" } }, "required": [ "file" ], "additionalProperties": true }, "ImageRequest": { "type": "object", "properties": { "prompt": { "type": "string", "minLength": 1 }, "model": { "type": "string", "description": "V1 uses the configured image backend; this field does not select a different model." }, "n": { "type": "integer", "minimum": 1, "maximum": 4, "default": 1 }, "size": { "type": "string", "default": "1024x1024", "description": "Accepted locally but not forwarded by V1; does not control output dimensions." }, "response_format": { "type": "string" } }, "required": [ "prompt" ], "additionalProperties": true } } } }