Memory
Call GPT generation and OpenAI text embedding models through RunAPI using OpenAI-compatible clients. Use for chat, Responses, embeddings, streaming, tools, vision, or an existing compatibility client that needs the conditional reference.
Call GPT generation and OpenAI text embedding models through RunAPI using OpenAI-compatible clients. Use for chat, Responses, embeddings, streaming, tools, vision, or an existing compatibility client that needs the conditional reference.
Use OpenAI-compatible clients at https://runapi.ai/v1 as the primary protocol.
Set OPENAI_API_KEY to a RunAPI API key and OPENAI_BASE_URL to https://runapi.ai/v1.
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.
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.
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.
Load compatibility protocols only when an existing client requires Anthropic Messages or Gemini contents.
| 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 |
Call Gemini 2.5 and 3 series models through RunAPI using Gemini contents clients. Use for Gemini chat, streaming, multimodal input, grounding, structured output, reasoning, or an existing compatibility client that needs the conditional reference.
Call Claude models through RunAPI using the Anthropic Messages protocol. Use for Claude chat, streaming, vision, tools, reasoning, token counting, or an existing compatibility client that needs the conditional reference.
Generate and edit images with GPT Image through RunAPI. Use when the user asks an agent to create, edit, or transform images with GPT Image. Default to the RunAPI CLI for one-off generation; use SDKs only when the user is integrating RunAPI into an app or backend.
Call the GLM API (GLM 5 and 4 series) through RunAPI using OpenAI-compatible Chat Completions. Use for GLM text chat, streaming, or an existing compatibility client that needs the conditional reference.
Generate and edit images with GPT Image 2 through RunAPI. Use when the user asks an agent to create, edit, or transform images with GPT Image 2. Default to the RunAPI CLI for one-off generation; use SDKs only when the user is integrating RunAPI into an app or backend.
Create Gemini Omni voice resources, character resources, and Flash Preview or multimodal text-to-video tasks through RunAPI. Use when the user asks an agent to create or manage Gemini Omni audio voices, character resources, or video. Default to the RunAPI CLI for one-off calls; use SDKs only when integrating RunAPI into an app or backend.