runapi-ai GPT on RunAPI
Use OpenAI-compatible clients at https://runapi.ai/v1 as the primary protocol.
Primary protocol recipe
Authenticate
Set OPENAI_API_KEY to a RunAPI API key and OPENAI_BASE_URL to https://runapi.ai/v1.
Send request
from openai import OpenAI
client = OpenAI(api_key="YOUR_RUNAPI_TOKEN", base_url="https://runapi.ai/v1")
response = client.responses.create(model="gpt-5.5", input="Summarize this review.")
print(response.output_text)
print(response.usage)
Use client.chat.completions.create for gpt-5.2, which does not accept
Responses. Use Responses for gpt-5.*-pro. Use client.embeddings.create only
with the three embedding model IDs below. For streaming Responses, set
stream=True and consume through one usage-bearing response.completed
followed by [DONE].
For gpt-5.6-luna, gpt-5.6-sol, and gpt-5.6-terra, start with text input,
sync or SSE transport, parameterized custom functions, and automatic prompt
caching. gpt-5.3-codex-spark has the same verified subset with parameterless
custom functions. Add reasoning controls, multimodal input, hosted tools, or
continuation state only when the current RunAPI contract verifies that shape.
Verify result
Responses require final output, response.completed, and usage. Chat requires
final assistant content, finish_reason, and usage. Embeddings require one
numeric vector per input and response usage.
Stop boundaries
Correct a rejected shape once using the current error and endpoint contract.
Retry transport once only before any response or Usage and when replay is safe.
Record a terminal error and stop without changing model, endpoint, or protocol.
Keep embedding models on /v1/embeddings.
Compatibility protocols
Load compatibility protocols only when an existing client requires Anthropic Messages or Gemini contents.
Supported models
| Model ID | Use when |
|---|---|
gpt-5.5 |
Latest general model |
gpt-5.5-pro |
Reasoning-heavy |
gpt-5.4 |
Production default |
gpt-5.4-mini |
Cost-optimized |
gpt-5.4-nano |
Smallest, fastest |
gpt-5.4-pro |
Reasoning |
gpt-5.3-codex |
Code generation |
gpt-5.3-codex-spark |
Faster Codex variant; text and parameterless functions in the consistently available Responses subset |
gpt-5.2 |
Cost-effective |
gpt-5.6-luna |
Text and parameterized functions in the consistently available Responses subset |
gpt-5.6-sol |
Text and parameterized functions in the consistently available Responses subset |
gpt-5.6-terra |
Text and parameterized functions in the consistently available Responses subset |
text-embedding-3-large |
High-capacity vectors |
text-embedding-3-small |
Efficient vectors |
text-embedding-ada-002 |
Legacy-compatible vectors |