{"components":{"responses":{"OAIError":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/OAIErrorBody"}}},"description":"OpenAI-shaped error"}},"schemas":{"NativeEmbedRequest":{"properties":{"dim":{"description":"Optional Matryoshka truncation.","type":"integer"},"input_type":{"default":"document","enum":["query","document"],"type":"string"},"model":{"default":"turbo","description":"turbo (1024) | pro (2560) | ultra (4096)","type":"string"},"texts":{"items":{"type":"string"},"type":"array"}},"required":["texts"],"type":"object"},"NativeEmbedResponse":{"properties":{"dim":{"type":"integer"},"embeddings":{"items":{"items":{"format":"float","type":"number"},"type":"array"},"type":"array"},"latency_ms":{"type":"integer"},"model":{"type":"string"},"tokens":{"type":"integer"}},"type":"object"},"OAIEmbeddingRequest":{"properties":{"dimensions":{"description":"Optional Matryoshka truncation (re-normalized). Must be ≤ the model's native dimension.","type":"integer"},"encoding_format":{"default":"float","enum":["float","base64"],"type":"string"},"input":{"description":"A string or array of strings to embed.","oneOf":[{"type":"string"},{"items":{"type":"string"},"type":"array"}]},"model":{"default":"text-embedding-3-small","description":"text-embedding-3-small (1536) | text-embedding-3-large (3072) | forge-turbo | forge-pro | forge-ultra-4k","type":"string"}},"required":["input"],"type":"object"},"OAIEmbeddingResponse":{"properties":{"data":{"items":{"properties":{"embedding":{"description":"Float array, or base64 string when encoding_format=base64.","oneOf":[{"items":{"format":"float","type":"number"},"type":"array"},{"type":"string"}]},"index":{"type":"integer"},"object":{"example":"embedding","type":"string"}},"type":"object"},"type":"array"},"model":{"type":"string"},"object":{"example":"list","type":"string"},"usage":{"properties":{"prompt_tokens":{"type":"integer"},"total_tokens":{"type":"integer"}},"type":"object"}},"type":"object"},"OAIErrorBody":{"properties":{"error":{"properties":{"code":{"nullable":true,"type":"string"},"message":{"type":"string"},"type":{"type":"string"}},"type":"object"}},"type":"object"}},"securitySchemes":{"bearerAuth":{"description":"Forge API key as a Bearer token.","scheme":"bearer","type":"http"}}},"info":{"contact":{"email":"support@voxell.ai","name":"Voxell Forge","url":"https://voxell.ai/forge"},"description":"Hosted text-embedding API — three tiers: turbo (1024d), pro (2560d), ultra (4096d). Exposes the OpenAI-compatible `/v1/embeddings` endpoint and a native `/v1/embed`. Free key at https://dash.voxell.ai (Turbo free forever, no card).\n","license":{"name":"Proprietary"},"title":"Forge — Voxell Embeddings API","version":"1.0.0"},"openapi":"3.0.3","paths":{"/v1/embed":{"post":{"description":"Forge-native embeddings. Asymmetric input_type (query vs document) for retrieval.","operationId":"embed","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/NativeEmbedRequest"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/NativeEmbedResponse"}}},"description":"OK"},"400":{"description":"Bad request"},"401":{"description":"Unauthorized"},"402":{"description":"Insufficient token balance"},"429":{"description":"Rate limited"}},"summary":"Create embeddings (native)"}},"/v1/embeddings":{"post":{"description":"OpenAI-compatible embeddings. Point any OpenAI client's base URL at https://api.voxell.ai/v1. Model names map to a matching dimension (text-embedding-3-small→1536, text-embedding-3-large→3072) or use forge-turbo/forge-pro/forge-ultra-4k.\n","operationId":"createEmbedding","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/OAIEmbeddingRequest"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/OAIEmbeddingResponse"}}},"description":"OK"},"400":{"$ref":"#/components/responses/OAIError"},"401":{"$ref":"#/components/responses/OAIError"},"402":{"$ref":"#/components/responses/OAIError"},"429":{"$ref":"#/components/responses/OAIError"}},"summary":"Create embeddings (OpenAI-compatible)"}}},"security":[{"bearerAuth":[]}],"servers":[{"url":"https://api.voxell.ai"}]}