curl https://api.snapgen.org/v1/chat/completions \
-H "Authorization: Bearer sk-xxxx" \
-H "Content-Type: application/json" \
-d '{
"model": "gpt-6.1-sol",
"messages": [
{
"role": "system",
"content": "You answer in one concise sentence."
},
{
"role": "user",
"content": "What is an API gateway?"
}
],
"reasoning_effort": "medium",
"max_completion_tokens": 2048
}'
{
"id": "chatcmpl_01HXYZ",
"object": "chat.completion",
"created": 1730000000,
"model": "gpt-6.1-sol",
"choices": [
{
"index": 0,
"message": {
"role": "assistant",
"content": "An API gateway is a service that provides one interface for routing requests to one or more APIs."
},
"finish_reason": "stop"
}
],
"usage": {
"prompt_tokens": 25,
"completion_tokens": 19,
"total_tokens": 44
}
}
Endpoint Reference
Chat Completions protocol
Common OpenAI-compatible chat request, response, and streaming rules.
POST
/
v1
/
chat
/
completions
curl https://api.snapgen.org/v1/chat/completions \
-H "Authorization: Bearer sk-xxxx" \
-H "Content-Type: application/json" \
-d '{
"model": "gpt-6.1-sol",
"messages": [
{
"role": "system",
"content": "You answer in one concise sentence."
},
{
"role": "user",
"content": "What is an API gateway?"
}
],
"reasoning_effort": "medium",
"max_completion_tokens": 2048
}'
{
"id": "chatcmpl_01HXYZ",
"object": "chat.completion",
"created": 1730000000,
"model": "gpt-6.1-sol",
"choices": [
{
"index": 0,
"message": {
"role": "assistant",
"content": "An API gateway is a service that provides one interface for routing requests to one or more APIs."
},
"finish_reason": "stop"
}
],
"usage": {
"prompt_tokens": 25,
"completion_tokens": 19,
"total_tokens": 44
}
}
Create a model response from a list of chat messages. GPT-5.6, GPT-6, Grok, Gemini, and DeepSeek models accept this protocol; choose an exact model page under Text Series for pricing and the recommended model ID.
Each event begins with
For the input/output item format used by agent clients, see the
Responses protocol.
string
required
A text model ID available to your API key. Use
GET /v1/models to discover IDs, then open its
individual model page for current pricing.array
required
Ordered chat messages. Each message includes a
role and content.boolean
default:"false"
Set to
true to receive server-sent events.number
Controls sampling variation where the selected model supports it. Some GPT
reasoning models restrict sampling parameters; omit it unless you have verified
support for your model and reasoning setting.
integer
Caps generated GPT-5.6 and GPT-6 tokens, including reasoning tokens. If you send
max_tokens instead, SnapGen forwards it as max_completion_tokens. When both
are present, max_completion_tokens wins.integer
Caps generated tokens for other model families. GPT-5.6 and GPT-6 accept it as
an alias for
max_completion_tokens.string
Sets GPT reasoning effort, for example
medium. Supported effort levels vary
by model; check your selected model’s capabilities before changing it.array
Function tools use the Chat Completions format:
{ "type": "function", "function": { "name": "...", "parameters": {} } }.
Read choices[].message.tool_calls, execute the requested functions in your
application, then send their results as role: "tool" messages with the matching
tool_call_id. SnapGen does not execute your functions.Stream a response
Setstream to true. The response uses server-sent events (SSE).
curl -N https://api.snapgen.org/v1/chat/completions \
-H "Authorization: Bearer sk-xxxx" \
-H "Content-Type: application/json" \
-d '{
"model": "gpt-6.1-sol",
"messages": [
{"role": "user", "content": "Say hello in three words."}
],
"stream": true
}'
data:. Read events until the data: [DONE] marker.
To request token usage in the stream, include stream_options: { "include_usage": true }.
data: {"id":"chatcmpl_01HXYZ","object":"chat.completion.chunk","choices":[{"index":0,"delta":{"role":"assistant","content":"Hello"},"finish_reason":null}]}
data: {"id":"chatcmpl_01HXYZ","object":"chat.completion.chunk","choices":[{"index":0,"delta":{"content":" from SnapGen"},"finish_reason":null}]}
data: [DONE]
Concatenate
choices[0].delta.content values as they arrive. A delta can omit content, especially in the first or final event.curl https://api.snapgen.org/v1/chat/completions \
-H "Authorization: Bearer sk-xxxx" \
-H "Content-Type: application/json" \
-d '{
"model": "gpt-6.1-sol",
"messages": [
{
"role": "system",
"content": "You answer in one concise sentence."
},
{
"role": "user",
"content": "What is an API gateway?"
}
],
"reasoning_effort": "medium",
"max_completion_tokens": 2048
}'
{
"id": "chatcmpl_01HXYZ",
"object": "chat.completion",
"created": 1730000000,
"model": "gpt-6.1-sol",
"choices": [
{
"index": 0,
"message": {
"role": "assistant",
"content": "An API gateway is a service that provides one interface for routing requests to one or more APIs."
},
"finish_reason": "stop"
}
],
"usage": {
"prompt_tokens": 25,
"completion_tokens": 19,
"total_tokens": 44
}
}