{"openapi":"3.1.0","info":{"title":"Telnyx x402 Gateway","version":"1.0.0","description":"Pay-per-call Telnyx AI inference, text-to-speech and speech-to-text. No Telnyx account or API key: each call is paid in USDC on Base over x402.","x-guidance":"OpenAI-compatible. Every paid operation answers an unpaid request with HTTP 402 and an x402 v2 challenge in the PAYMENT-REQUIRED header; pay in USDC on Base with the `exact` scheme (flat price per call) or the `upto` scheme (metered, settles at or below the advertised ceiling) and retry with PAYMENT-SIGNATURE. Chat: POST /v1/chat/completions/_t/<tier> with a JSON body {model, messages, max_tokens}; each tier path serves exactly one model, named in its schema. OpenAI SDK clients can instead POST /v1/chat/completions with the same body and the gateway picks the tier from `model`. GET /v1/models is free and lists every model with its price, limits and tier path. Speech: POST /v1/audio/speech (JSON in, audio/mpeg out). Transcription: POST /v1/audio/transcriptions (multipart form with a `file` part). Failed upstream calls are not charged.","contact":{"email":"ai.fde.squad@telnyx.com"}},"servers":[{"url":"https://x402.telnyx.com"}],"paths":{"/v1/chat/completions/_t/kimi-k3":{"post":{"operationId":"post_v1_chat_completions_kimi_k3","summary":"Featured model","description":"Featured model. Frontier thinking-model chat completions via Telnyx Inference (Kimi K3) — hidden reasoning tokens count toward max_tokens, so max_tokens must be 4096–8192 (omit it for the full 8192-token budget). OpenAI-compatible. $0.150193 USDC per call, or pay per-token via the upto scheme.","security":[],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.150193"},"protocols":[{"x402":{}}]},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["model","messages"],"properties":{"model":{"type":"string","const":"moonshotai/Kimi-K3","description":"Model identifier; fixed to moonshotai/Kimi-K3 on this route."},"messages":{"type":"array","description":"OpenAI-style chat messages.","items":{"type":"object","required":["role","content"],"properties":{"role":{"type":"string","enum":["system","user","assistant","tool"]},"content":{"type":"string","maxLength":12000}}},"maxItems":32},"max_tokens":{"type":"integer","minimum":4096,"maximum":8192},"n":{"type":"integer","const":1,"description":"Fixed to one completion per paid call."},"temperature":{"type":"number","minimum":0,"maximum":2},"tools":{"type":"array","maxItems":16,"items":{"type":"object"}}}},"example":{"model":"moonshotai/Kimi-K3","messages":[{"role":"user","content":"Say hello in one short sentence."}],"max_tokens":4096}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object"},"example":{"id":"chatcmpl-xxx","object":"chat.completion","choices":[{"index":0,"message":{"role":"assistant","content":"Hello!"},"finish_reason":"stop"}],"usage":{"prompt_tokens":12,"completion_tokens":4,"total_tokens":16}}}}},"402":{"description":"Payment Required — x402 v2 challenge in the PAYMENT-REQUIRED header"}}}},"/v1/chat/completions/_t/glm-5.3-flash":{"post":{"operationId":"post_v1_chat_completions_glm_5_3_flash","summary":"Featured model","description":"Featured model. Chat completions via Telnyx Inference (zai-org/GLM-5.3-Flash), run at low reasoning effort for direct answers. max_tokens must be 512–2048 (omit it for the 1024-token default). OpenAI-compatible. $0.005783 USDC per call, or pay per-token via the upto scheme.","security":[],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.005783"},"protocols":[{"x402":{}}]},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["model","messages"],"properties":{"model":{"type":"string","const":"zai-org/GLM-5.3-Flash","description":"Model identifier; fixed to zai-org/GLM-5.3-Flash on this route."},"messages":{"type":"array","description":"OpenAI-style chat messages.","items":{"type":"object","required":["role","content"],"properties":{"role":{"type":"string","enum":["system","user","assistant","tool"]},"content":{"type":"string","maxLength":32000}}},"maxItems":32},"max_tokens":{"type":"integer","minimum":512,"maximum":2048},"n":{"type":"integer","const":1,"description":"Fixed to one completion per paid call."},"temperature":{"type":"number","minimum":0,"maximum":2},"tools":{"type":"array","maxItems":16,"items":{"type":"object"}}}},"example":{"model":"zai-org/GLM-5.3-Flash","messages":[{"role":"user","content":"Say hello in one short sentence."}],"max_tokens":512}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object"},"example":{"id":"chatcmpl-xxx","object":"chat.completion","choices":[{"index":0,"message":{"role":"assistant","content":"Hello!"},"finish_reason":"stop"}],"usage":{"prompt_tokens":12,"completion_tokens":4,"total_tokens":16}}}}},"402":{"description":"Payment Required — x402 v2 challenge in the PAYMENT-REQUIRED header"}}}},"/v1/chat/completions/_t/deepseek-v4.1-flash":{"post":{"operationId":"post_v1_chat_completions_deepseek_v4_1_flash","summary":"Featured model","description":"Featured model. Chat completions via Telnyx Inference (deepseek-ai/DeepSeek-V4.1-Flash). OpenAI-compatible. $0.013259 USDC per call.","security":[],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.013259"},"protocols":[{"x402":{}}]},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["model","messages"],"properties":{"model":{"type":"string","const":"deepseek-ai/DeepSeek-V4.1-Flash","description":"Model identifier; fixed to deepseek-ai/DeepSeek-V4.1-Flash on this route."},"messages":{"type":"array","description":"OpenAI-style chat messages.","items":{"type":"object","required":["role","content"],"properties":{"role":{"type":"string","enum":["system","user","assistant","tool"]},"content":{"type":"string","maxLength":32000}}},"maxItems":32},"max_tokens":{"type":"integer","minimum":1,"maximum":2048},"n":{"type":"integer","const":1,"description":"Fixed to one completion per paid call."},"temperature":{"type":"number","minimum":0,"maximum":2},"tools":{"type":"array","maxItems":16,"items":{"type":"object"}}}},"example":{"model":"deepseek-ai/DeepSeek-V4.1-Flash","messages":[{"role":"user","content":"Say hello in one short sentence."}],"max_tokens":64}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object"},"example":{"id":"chatcmpl-xxx","object":"chat.completion","choices":[{"index":0,"message":{"role":"assistant","content":"Hello!"},"finish_reason":"stop"}],"usage":{"prompt_tokens":12,"completion_tokens":4,"total_tokens":16}}}}},"402":{"description":"Payment Required — x402 v2 challenge in the PAYMENT-REQUIRED header"}}}},"/v1/chat/completions/_t/glm-5.2":{"post":{"operationId":"post_v1_chat_completions_glm_5_2","summary":"Chat completions via Telnyx Inference (zai-org/GLM-5.2)","description":"Chat completions via Telnyx Inference (zai-org/GLM-5.2). OpenAI-compatible. $0.037526 USDC per call.","security":[],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.037526"},"protocols":[{"x402":{}}]},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["model","messages"],"properties":{"model":{"type":"string","const":"zai-org/GLM-5.2","description":"Model identifier; fixed to zai-org/GLM-5.2 on this route."},"messages":{"type":"array","description":"OpenAI-style chat messages.","items":{"type":"object","required":["role","content"],"properties":{"role":{"type":"string","enum":["system","user","assistant","tool"]},"content":{"type":"string","maxLength":32000}}},"maxItems":32},"max_tokens":{"type":"integer","minimum":1,"maximum":2048},"n":{"type":"integer","const":1,"description":"Fixed to one completion per paid call."},"temperature":{"type":"number","minimum":0,"maximum":2},"tools":{"type":"array","maxItems":16,"items":{"type":"object"}}}},"example":{"model":"zai-org/GLM-5.2","messages":[{"role":"user","content":"Say hello in one short sentence."}],"max_tokens":64}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object"},"example":{"id":"chatcmpl-xxx","object":"chat.completion","choices":[{"index":0,"message":{"role":"assistant","content":"Hello!"},"finish_reason":"stop"}],"usage":{"prompt_tokens":12,"completion_tokens":4,"total_tokens":16}}}}},"402":{"description":"Payment Required — x402 v2 challenge in the PAYMENT-REQUIRED header"}}}},"/v1/chat/completions/_t/minimax-m3":{"post":{"operationId":"post_v1_chat_completions_minimax_m3","summary":"Chat completions via Telnyx Inference (MiniMaxAI/MiniMax-M3-MXFP8)","description":"Chat completions via Telnyx Inference (MiniMaxAI/MiniMax-M3-MXFP8). OpenAI-compatible. $0.011974 USDC per call.","security":[],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.011974"},"protocols":[{"x402":{}}]},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["model","messages"],"properties":{"model":{"type":"string","const":"MiniMaxAI/MiniMax-M3-MXFP8","description":"Model identifier; fixed to MiniMaxAI/MiniMax-M3-MXFP8 on this route."},"messages":{"type":"array","description":"OpenAI-style chat messages.","items":{"type":"object","required":["role","content"],"properties":{"role":{"type":"string","enum":["system","user","assistant","tool"]},"content":{"type":"string","maxLength":32000}}},"maxItems":32},"max_tokens":{"type":"integer","minimum":1,"maximum":2048},"n":{"type":"integer","const":1,"description":"Fixed to one completion per paid call."},"temperature":{"type":"number","minimum":0,"maximum":2},"tools":{"type":"array","maxItems":16,"items":{"type":"object"}}}},"example":{"model":"MiniMaxAI/MiniMax-M3-MXFP8","messages":[{"role":"user","content":"Say hello in one short sentence."}],"max_tokens":64}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object"},"example":{"id":"chatcmpl-xxx","object":"chat.completion","choices":[{"index":0,"message":{"role":"assistant","content":"Hello!"},"finish_reason":"stop"}],"usage":{"prompt_tokens":12,"completion_tokens":4,"total_tokens":16}}}}},"402":{"description":"Payment Required — x402 v2 challenge in the PAYMENT-REQUIRED header"}}}},"/v1/chat/completions/_t/mid":{"post":{"operationId":"post_v1_chat_completions_mid","summary":"Mid-tier chat completions via Telnyx Inference (Kimi K2.6, MoE) — larger context (up to 36K chars input) and 1024-token output","description":"Mid-tier chat completions via Telnyx Inference (Kimi K2.6, MoE) — larger context (up to 36K chars input) and 1024-token output. OpenAI-compatible. $0.01385 USDC per call.","security":[],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.01385"},"protocols":[{"x402":{}}]},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["model","messages"],"properties":{"model":{"type":"string","const":"moonshotai/Kimi-K2.6","description":"Model identifier; fixed to moonshotai/Kimi-K2.6 on this route."},"messages":{"type":"array","description":"OpenAI-style chat messages.","items":{"type":"object","required":["role","content"],"properties":{"role":{"type":"string","enum":["system","user","assistant","tool"]},"content":{"type":"string","maxLength":12000}}},"maxItems":32},"max_tokens":{"type":"integer","minimum":1,"maximum":1024},"n":{"type":"integer","const":1,"description":"Fixed to one completion per paid call."},"temperature":{"type":"number","minimum":0,"maximum":2},"tools":{"type":"array","maxItems":16,"items":{"type":"object"}}}},"example":{"model":"moonshotai/Kimi-K2.6","messages":[{"role":"user","content":"Say hello in one short sentence."}],"max_tokens":64}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object"},"example":{"id":"chatcmpl-xxx","object":"chat.completion","choices":[{"index":0,"message":{"role":"assistant","content":"Hello!"},"finish_reason":"stop"}],"usage":{"prompt_tokens":12,"completion_tokens":4,"total_tokens":16}}}}},"402":{"description":"Payment Required — x402 v2 challenge in the PAYMENT-REQUIRED header"}}}},"/v1/chat/completions/_t/deepseek-v4-flash-0731":{"post":{"operationId":"post_v1_chat_completions_deepseek_v4_flash_0731","summary":"Chat completions via Telnyx Inference (deepseek-ai/DeepSeek-V4-Flash-0731)","description":"Chat completions via Telnyx Inference (deepseek-ai/DeepSeek-V4-Flash-0731). OpenAI-compatible. $0.005214 USDC per call.","security":[],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.005214"},"protocols":[{"x402":{}}]},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["model","messages"],"properties":{"model":{"type":"string","const":"deepseek-ai/DeepSeek-V4-Flash-0731","description":"Model identifier; fixed to deepseek-ai/DeepSeek-V4-Flash-0731 on this route."},"messages":{"type":"array","description":"OpenAI-style chat messages.","items":{"type":"object","required":["role","content"],"properties":{"role":{"type":"string","enum":["system","user","assistant","tool"]},"content":{"type":"string","maxLength":32000}}},"maxItems":32},"max_tokens":{"type":"integer","minimum":1,"maximum":2048},"n":{"type":"integer","const":1,"description":"Fixed to one completion per paid call."},"temperature":{"type":"number","minimum":0,"maximum":2},"tools":{"type":"array","maxItems":16,"items":{"type":"object"}}}},"example":{"model":"deepseek-ai/DeepSeek-V4-Flash-0731","messages":[{"role":"user","content":"Say hello in one short sentence."}],"max_tokens":64}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object"},"example":{"id":"chatcmpl-xxx","object":"chat.completion","choices":[{"index":0,"message":{"role":"assistant","content":"Hello!"},"finish_reason":"stop"}],"usage":{"prompt_tokens":12,"completion_tokens":4,"total_tokens":16}}}}},"402":{"description":"Payment Required — x402 v2 challenge in the PAYMENT-REQUIRED header"}}}},"/v1/chat/completions/_t/mini":{"post":{"operationId":"post_v1_chat_completions_mini","summary":"Frontier chat completions via Telnyx Inference (MiniMax M2.7)","description":"Frontier chat completions via Telnyx Inference (MiniMax M2.7). Reasoning tokens count toward max_tokens, so max_tokens must be 512–4096 (omit it for 4096). OpenAI-compatible. $0.007157 USDC per call — no API key, no signup, pay per request.","security":[],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.007157"},"protocols":[{"x402":{}}]},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["model","messages"],"properties":{"model":{"type":"string","const":"MiniMaxAI/MiniMax-M2.7","description":"Model identifier; fixed to MiniMaxAI/MiniMax-M2.7 on this route."},"messages":{"type":"array","description":"OpenAI-style chat messages.","items":{"type":"object","required":["role","content"],"properties":{"role":{"type":"string","enum":["system","user","assistant","tool"]},"content":{"type":"string","maxLength":8000}}},"maxItems":32},"max_tokens":{"type":"integer","minimum":512,"maximum":4096},"n":{"type":"integer","const":1,"description":"Fixed to one completion per paid call."},"temperature":{"type":"number","minimum":0,"maximum":2},"tools":{"type":"array","maxItems":16,"items":{"type":"object"}}}},"example":{"model":"MiniMaxAI/MiniMax-M2.7","messages":[{"role":"user","content":"Say hello in one short sentence."}],"max_tokens":512}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object"},"example":{"id":"chatcmpl-xxx","object":"chat.completion","choices":[{"index":0,"message":{"role":"assistant","content":"Hello!"},"finish_reason":"stop"}],"usage":{"prompt_tokens":12,"completion_tokens":4,"total_tokens":16}}}}},"402":{"description":"Payment Required — x402 v2 challenge in the PAYMENT-REQUIRED header"}}}},"/v1/chat/completions/_t/kimi-k2.5":{"post":{"operationId":"post_v1_chat_completions_kimi_k2_5","summary":"Chat completions via Telnyx Inference (moonshotai/Kimi-K2.5)","description":"Chat completions via Telnyx Inference (moonshotai/Kimi-K2.5). OpenAI-compatible. $0.016673 USDC per call.","security":[],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.016673"},"protocols":[{"x402":{}}]},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["model","messages"],"properties":{"model":{"type":"string","const":"moonshotai/Kimi-K2.5","description":"Model identifier; fixed to moonshotai/Kimi-K2.5 on this route."},"messages":{"type":"array","description":"OpenAI-style chat messages.","items":{"type":"object","required":["role","content"],"properties":{"role":{"type":"string","enum":["system","user","assistant","tool"]},"content":{"type":"string","maxLength":20000}}},"maxItems":32},"max_tokens":{"type":"integer","minimum":1,"maximum":1024},"n":{"type":"integer","const":1,"description":"Fixed to one completion per paid call."},"temperature":{"type":"number","minimum":0,"maximum":2},"tools":{"type":"array","maxItems":16,"items":{"type":"object"}}}},"example":{"model":"moonshotai/Kimi-K2.5","messages":[{"role":"user","content":"Say hello in one short sentence."}],"max_tokens":64}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object"},"example":{"id":"chatcmpl-xxx","object":"chat.completion","choices":[{"index":0,"message":{"role":"assistant","content":"Hello!"},"finish_reason":"stop"}],"usage":{"prompt_tokens":12,"completion_tokens":4,"total_tokens":16}}}}},"402":{"description":"Payment Required — x402 v2 challenge in the PAYMENT-REQUIRED header"}}}},"/v1/chat/completions/_t/glm":{"post":{"operationId":"post_v1_chat_completions_glm","summary":"Reasoning-tier chat completions via Telnyx Inference (GLM-5.1-FP8) — 12K-char-per-message input, 2048-token output","description":"Reasoning-tier chat completions via Telnyx Inference (GLM-5.1-FP8) — 12K-char-per-message input, 2048-token output. OpenAI-compatible. $0.023386 USDC per call.","security":[],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.023386"},"protocols":[{"x402":{}}]},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["model","messages"],"properties":{"model":{"type":"string","const":"zai-org/GLM-5.1-FP8","description":"Model identifier; fixed to zai-org/GLM-5.1-FP8 on this route."},"messages":{"type":"array","description":"OpenAI-style chat messages.","items":{"type":"object","required":["role","content"],"properties":{"role":{"type":"string","enum":["system","user","assistant","tool"]},"content":{"type":"string","maxLength":12000}}},"maxItems":32},"max_tokens":{"type":"integer","minimum":1,"maximum":2048},"n":{"type":"integer","const":1,"description":"Fixed to one completion per paid call."},"temperature":{"type":"number","minimum":0,"maximum":2},"tools":{"type":"array","maxItems":16,"items":{"type":"object"}}}},"example":{"model":"zai-org/GLM-5.1-FP8","messages":[{"role":"user","content":"Say hello in one short sentence."}],"max_tokens":64}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object"},"example":{"id":"chatcmpl-xxx","object":"chat.completion","choices":[{"index":0,"message":{"role":"assistant","content":"Hello!"},"finish_reason":"stop"}],"usage":{"prompt_tokens":12,"completion_tokens":4,"total_tokens":16}}}}},"402":{"description":"Payment Required — x402 v2 challenge in the PAYMENT-REQUIRED header"}}}},"/v1/chat/completions/_t/qwen3-235b":{"post":{"operationId":"post_v1_chat_completions_qwen3_235b","summary":"Chat completions via Telnyx Inference (Qwen/Qwen3-235B-A22B)","description":"Chat completions via Telnyx Inference (Qwen/Qwen3-235B-A22B). OpenAI-compatible. $0.010497 USDC per call.","security":[],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.010497"},"protocols":[{"x402":{}}]},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["model","messages"],"properties":{"model":{"type":"string","const":"Qwen/Qwen3-235B-A22B","description":"Model identifier; fixed to Qwen/Qwen3-235B-A22B on this route."},"messages":{"type":"array","description":"OpenAI-style chat messages.","items":{"type":"object","required":["role","content"],"properties":{"role":{"type":"string","enum":["system","user","assistant","tool"]},"content":{"type":"string","maxLength":8000}}},"maxItems":32},"max_tokens":{"type":"integer","minimum":1,"maximum":2048},"n":{"type":"integer","const":1,"description":"Fixed to one completion per paid call."},"temperature":{"type":"number","minimum":0,"maximum":2},"tools":{"type":"array","maxItems":16,"items":{"type":"object"}}}},"example":{"model":"Qwen/Qwen3-235B-A22B","messages":[{"role":"user","content":"Say hello in one short sentence."}],"max_tokens":64}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object"},"example":{"id":"chatcmpl-xxx","object":"chat.completion","choices":[{"index":0,"message":{"role":"assistant","content":"Hello!"},"finish_reason":"stop"}],"usage":{"prompt_tokens":12,"completion_tokens":4,"total_tokens":16}}}}},"402":{"description":"Payment Required — x402 v2 challenge in the PAYMENT-REQUIRED header"}}}},"/v1/chat/completions/_t/gemma-4-26b":{"post":{"operationId":"post_v1_chat_completions_gemma_4_26b","summary":"Chat completions via Telnyx Inference (google/gemma-4-26B-A4B-it)","description":"Chat completions via Telnyx Inference (google/gemma-4-26B-A4B-it). OpenAI-compatible. $0.003139 USDC per call.","security":[],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.003139"},"protocols":[{"x402":{}}]},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["model","messages"],"properties":{"model":{"type":"string","const":"google/gemma-4-26B-A4B-it","description":"Model identifier; fixed to google/gemma-4-26B-A4B-it on this route."},"messages":{"type":"array","description":"OpenAI-style chat messages.","items":{"type":"object","required":["role","content"],"properties":{"role":{"type":"string","enum":["system","user","assistant","tool"]},"content":{"type":"string","maxLength":12000}}},"maxItems":32},"max_tokens":{"type":"integer","minimum":1,"maximum":1024},"n":{"type":"integer","const":1,"description":"Fixed to one completion per paid call."},"temperature":{"type":"number","minimum":0,"maximum":2},"tools":{"type":"array","maxItems":16,"items":{"type":"object"}}}},"example":{"model":"google/gemma-4-26B-A4B-it","messages":[{"role":"user","content":"Say hello in one short sentence."}],"max_tokens":64}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object"},"example":{"id":"chatcmpl-xxx","object":"chat.completion","choices":[{"index":0,"message":{"role":"assistant","content":"Hello!"},"finish_reason":"stop"}],"usage":{"prompt_tokens":12,"completion_tokens":4,"total_tokens":16}}}}},"402":{"description":"Payment Required — x402 v2 challenge in the PAYMENT-REQUIRED header"}}}},"/v1/chat/completions/_t/llama-3.3-70b":{"post":{"operationId":"post_v1_chat_completions_llama_3_3_70b","summary":"Chat completions via Telnyx Inference (meta-llama/Llama-3.3-70B-Instruct)","description":"Chat completions via Telnyx Inference (meta-llama/Llama-3.3-70B-Instruct). OpenAI-compatible. $0.007016 USDC per call.","security":[],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.007016"},"protocols":[{"x402":{}}]},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["model","messages"],"properties":{"model":{"type":"string","const":"meta-llama/Llama-3.3-70B-Instruct","description":"Model identifier; fixed to meta-llama/Llama-3.3-70B-Instruct on this route."},"messages":{"type":"array","description":"OpenAI-style chat messages.","items":{"type":"object","required":["role","content"],"properties":{"role":{"type":"string","enum":["system","user","assistant","tool"]},"content":{"type":"string","maxLength":8000}}},"maxItems":32},"max_tokens":{"type":"integer","minimum":1,"maximum":1024},"n":{"type":"integer","const":1,"description":"Fixed to one completion per paid call."},"temperature":{"type":"number","minimum":0,"maximum":2},"tools":{"type":"array","maxItems":16,"items":{"type":"object"}}}},"example":{"model":"meta-llama/Llama-3.3-70B-Instruct","messages":[{"role":"user","content":"Say hello in one short sentence."}],"max_tokens":64}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object"},"example":{"id":"chatcmpl-xxx","object":"chat.completion","choices":[{"index":0,"message":{"role":"assistant","content":"Hello!"},"finish_reason":"stop"}],"usage":{"prompt_tokens":12,"completion_tokens":4,"total_tokens":16}}}}},"402":{"description":"Payment Required — x402 v2 challenge in the PAYMENT-REQUIRED header"}}}},"/v1/chat/completions/_t/kimi-long":{"post":{"operationId":"post_v1_chat_completions_kimi_long","summary":"Long-context chat completions via Telnyx Inference (Kimi K2.6) — 200K-char input window, 2048-token output","description":"Long-context chat completions via Telnyx Inference (Kimi K2.6) — 200K-char input window, 2048-token output. OpenAI-compatible. $0.0543 USDC per call.","security":[],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.0543"},"protocols":[{"x402":{}}]},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["model","messages"],"properties":{"model":{"type":"string","const":"moonshotai/Kimi-K2.6-long","description":"Model identifier; fixed to moonshotai/Kimi-K2.6-long on this route."},"messages":{"type":"array","description":"OpenAI-style chat messages.","items":{"type":"object","required":["role","content"],"properties":{"role":{"type":"string","enum":["system","user","assistant","tool"]},"content":{"type":"string","maxLength":200000}}},"maxItems":64},"max_tokens":{"type":"integer","minimum":1,"maximum":2048},"n":{"type":"integer","const":1,"description":"Fixed to one completion per paid call."},"temperature":{"type":"number","minimum":0,"maximum":2},"tools":{"type":"array","maxItems":16,"items":{"type":"object"}}}},"example":{"model":"moonshotai/Kimi-K2.6-long","messages":[{"role":"user","content":"Say hello in one short sentence."}],"max_tokens":64}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object"},"example":{"id":"chatcmpl-xxx","object":"chat.completion","choices":[{"index":0,"message":{"role":"assistant","content":"Hello!"},"finish_reason":"stop"}],"usage":{"prompt_tokens":12,"completion_tokens":4,"total_tokens":16}}}}},"402":{"description":"Payment Required — x402 v2 challenge in the PAYMENT-REQUIRED header"}}}},"/v1/chat/completions/_t/llama-3.1-70b":{"post":{"operationId":"post_v1_chat_completions_llama_3_1_70b","summary":"Chat completions via Telnyx Inference (meta-llama/Meta-Llama-3.1-70B-Instruct)","description":"Chat completions via Telnyx Inference (meta-llama/Meta-Llama-3.1-70B-Instruct). OpenAI-compatible. $0.007016 USDC per call.","security":[],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.007016"},"protocols":[{"x402":{}}]},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["model","messages"],"properties":{"model":{"type":"string","const":"meta-llama/Meta-Llama-3.1-70B-Instruct","description":"Model identifier; fixed to meta-llama/Meta-Llama-3.1-70B-Instruct on this route."},"messages":{"type":"array","description":"OpenAI-style chat messages.","items":{"type":"object","required":["role","content"],"properties":{"role":{"type":"string","enum":["system","user","assistant","tool"]},"content":{"type":"string","maxLength":8000}}},"maxItems":32},"max_tokens":{"type":"integer","minimum":1,"maximum":1024},"n":{"type":"integer","const":1,"description":"Fixed to one completion per paid call."},"temperature":{"type":"number","minimum":0,"maximum":2},"tools":{"type":"array","maxItems":16,"items":{"type":"object"}}}},"example":{"model":"meta-llama/Meta-Llama-3.1-70B-Instruct","messages":[{"role":"user","content":"Say hello in one short sentence."}],"max_tokens":64}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object"},"example":{"id":"chatcmpl-xxx","object":"chat.completion","choices":[{"index":0,"message":{"role":"assistant","content":"Hello!"},"finish_reason":"stop"}],"usage":{"prompt_tokens":12,"completion_tokens":4,"total_tokens":16}}}}},"402":{"description":"Payment Required — x402 v2 challenge in the PAYMENT-REQUIRED header"}}}},"/v1/chat/completions/_t/llama-3.1-8b":{"post":{"operationId":"post_v1_chat_completions_llama_3_1_8b","summary":"Chat completions via Telnyx Inference (meta-llama/Meta-Llama-3.1-8B-Instruct)","description":"Chat completions via Telnyx Inference (meta-llama/Meta-Llama-3.1-8B-Instruct). OpenAI-compatible. $0.002237 USDC per call.","security":[],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.002237"},"protocols":[{"x402":{}}]},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["model","messages"],"properties":{"model":{"type":"string","const":"meta-llama/Meta-Llama-3.1-8B-Instruct","description":"Model identifier; fixed to meta-llama/Meta-Llama-3.1-8B-Instruct on this route."},"messages":{"type":"array","description":"OpenAI-style chat messages.","items":{"type":"object","required":["role","content"],"properties":{"role":{"type":"string","enum":["system","user","assistant","tool"]},"content":{"type":"string","maxLength":8000}}},"maxItems":32},"max_tokens":{"type":"integer","minimum":1,"maximum":512},"n":{"type":"integer","const":1,"description":"Fixed to one completion per paid call."},"temperature":{"type":"number","minimum":0,"maximum":2},"tools":{"type":"array","maxItems":16,"items":{"type":"object"}}}},"example":{"model":"meta-llama/Meta-Llama-3.1-8B-Instruct","messages":[{"role":"user","content":"Say hello in one short sentence."}],"max_tokens":64}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object"},"example":{"id":"chatcmpl-xxx","object":"chat.completion","choices":[{"index":0,"message":{"role":"assistant","content":"Hello!"},"finish_reason":"stop"}],"usage":{"prompt_tokens":12,"completion_tokens":4,"total_tokens":16}}}}},"402":{"description":"Payment Required — x402 v2 challenge in the PAYMENT-REQUIRED header"}}}},"/v1/chat/completions/_t/gemma-2b":{"post":{"operationId":"post_v1_chat_completions_gemma_2b","summary":"Chat completions via Telnyx Inference (google/gemma-2b-it)","description":"Chat completions via Telnyx Inference (google/gemma-2b-it). OpenAI-compatible. $0.002 USDC per call.","security":[],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.002"},"protocols":[{"x402":{}}]},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["model","messages"],"properties":{"model":{"type":"string","const":"google/gemma-2b-it","description":"Model identifier; fixed to google/gemma-2b-it on this route."},"messages":{"type":"array","description":"OpenAI-style chat messages.","items":{"type":"object","required":["role","content"],"properties":{"role":{"type":"string","enum":["system","user","assistant","tool"]},"content":{"type":"string","maxLength":2000}}},"maxItems":32},"max_tokens":{"type":"integer","minimum":1,"maximum":256},"n":{"type":"integer","const":1,"description":"Fixed to one completion per paid call."},"temperature":{"type":"number","minimum":0,"maximum":2},"tools":{"type":"array","maxItems":16,"items":{"type":"object"}}}},"example":{"model":"google/gemma-2b-it","messages":[{"role":"user","content":"Say hello in one short sentence."}],"max_tokens":64}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object"},"example":{"id":"chatcmpl-xxx","object":"chat.completion","choices":[{"index":0,"message":{"role":"assistant","content":"Hello!"},"finish_reason":"stop"}],"usage":{"prompt_tokens":12,"completion_tokens":4,"total_tokens":16}}}}},"402":{"description":"Payment Required — x402 v2 challenge in the PAYMENT-REQUIRED header"}}}},"/v1/audio/speech":{"post":{"operationId":"post_v1_audio_speech","summary":"Text-to-speech (OpenAI-compatible /v1/audio/speech)","description":"Text-to-speech (OpenAI-compatible /v1/audio/speech). 4,358 voices across 9 providers (KokoroTTS, AWS Polly, Azure, MiniMax, more — free catalog at GET /v1/audio/voices). Returns mp3. Up to 3000 chars. $0.000006 USDC per character (Telnyx list rate, zero margin): pay per character via the upto scheme (min $0.002 network settlement floor, so ≤333-char calls settle at $0.002), or flat $0.018 exact.","security":[],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.018"},"protocols":[{"x402":{}}]},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["input","voice"],"properties":{"model":{"type":"string","description":"Accepted for OpenAI SDK compatibility; the voice id selects the engine."},"input":{"type":"string","minLength":1,"maxLength":3000,"description":"Text to synthesize (max 3000 characters)."},"voice":{"type":"string","description":"OpenAI voice name (alloy, echo, fable, onyx, nova, shimmer, …) or Telnyx voice id (Provider.Model.VoiceId). Full catalog: GET /v1/audio/voices."},"response_format":{"type":"string","enum":["mp3"]}}},"example":{"model":"tts-1","input":"Hello from the Telnyx x402 gateway.","voice":"alloy"}}}},"responses":{"200":{"description":"Successful response","content":{"audio/mpeg":{"schema":{"type":"string","format":"binary"}}}},"402":{"description":"Payment Required — x402 v2 challenge in the PAYMENT-REQUIRED header"}}}},"/v1/audio/transcriptions":{"post":{"operationId":"post_v1_audio_transcriptions","summary":"Speech-to-text (OpenAI-compatible /v1/audio/transcriptions, multipart)","description":"Speech-to-text (OpenAI-compatible /v1/audio/transcriptions, multipart). Whisper large-v3-turbo, 100 languages, verbose_json with segment timestamps + duration. wav/mp3 up to 5 min / 12 MB. $0.003 USDC per minute (Telnyx list rate, zero margin), metered per second via the upto scheme (min $0.002 network floor ≈ 40s), or flat $0.015 exact.","security":[],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.015"},"protocols":[{"x402":{}}]},"requestBody":{"required":true,"content":{"multipart/form-data":{"schema":{"type":"object","required":["file"],"properties":{"file":{"type":"string","description":"Audio file (multipart part named \"file\"): wav or mp3, ≤5 minutes, ≤12 MB."},"model":{"type":"string","enum":["whisper-1","whisper-large-v3-turbo","openai/whisper-large-v3-turbo"],"description":"All aliases run openai/whisper-large-v3-turbo."},"response_format":{"type":"string","enum":["json","verbose_json"]},"language":{"type":"string","description":"Optional ISO-639-1 hint."},"prompt":{"type":"string","maxLength":1024},"temperature":{"type":"number","minimum":0,"maximum":1},"timestamp_granularities":{"type":"array","items":{"type":"string","enum":["segment"]},"description":"Segment-level only (upstream does not support word)."}}},"example":{"file":"<multipart part \"file\": wav or mp3 bytes>","model":"whisper-1","response_format":"verbose_json"}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object"},"example":{"text":"Hello from the x402 gateway.","duration":4.05,"segments":[{"id":0,"start":0,"end":4,"text":"Hello from the x402 gateway."}]}}}},"402":{"description":"Payment Required — x402 v2 challenge in the PAYMENT-REQUIRED header"}}}},"/v1/models":{"get":{"operationId":"get_v1_models","summary":"List models with per-call price, limits and tier path (free)","security":[],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/v1/audio/voices":{"get":{"operationId":"get_v1_audio_voices","summary":"List text-to-speech voices (free)","security":[],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object"}}}}}}}}}