Create a message (Anthropic Messages API)
const url = 'https://api.saygm.com/v1/messages';const options = { method: 'POST', headers: { 'anthropic-version': '2023-06-01', 'X-GM-Routing': 'default', 'x-api-key': '<x-api-key>', 'Content-Type': 'application/json' }, body: '{"model":"claude-sonnet-4-6","max_tokens":1,"messages":[{"role":"user","content":[{"type":"example","text":"example","source":{},"id":"example","name":"example","input":{}}]}],"system":[{}],"stream":false,"temperature":1,"top_p":1,"top_k":1,"stop_sequences":["example"],"tools":[{}],"tool_choice":{},"metadata":{}}'};
try { const response = await fetch(url, options); const data = await response.json(); console.log(data);} catch (error) { console.error(error);}curl --request POST \ --url https://api.saygm.com/v1/messages \ --header 'Content-Type: application/json' \ --header 'X-GM-Routing: default' \ --header 'anthropic-version: 2023-06-01' \ --header 'x-api-key: <x-api-key>' \ --data '{ "model": "claude-sonnet-4-6", "max_tokens": 1, "messages": [ { "role": "user", "content": [ { "type": "example", "text": "example", "source": {}, "id": "example", "name": "example", "input": {} } ] } ], "system": [ {} ], "stream": false, "temperature": 1, "top_p": 1, "top_k": 1, "stop_sequences": [ "example" ], "tools": [ {} ], "tool_choice": {}, "metadata": {} }'Anthropic-compatible Messages API. The gateway requires Anthropic’s anthropic-version header and authenticates with the GM API key in the native x-api-key header. Set the Anthropic SDK base_url to https://api.saygm.com.
Authorizations
Section titled “Authorizations”Parameters
Section titled “Parameters”Header Parameters
Section titled “Header Parameters”Example
2023-06-01Anthropic API version. The gateway rejects a missing or blank value before routing.
Per-request routing mode. default (or omitting the header) follows GM’s configured routing; cheapest ranks eligible routes by predicted final charge, preferring routes with at least 95% recent reliability; fastest ranks them by measured time to first token and output speed. Predictions are not a price cap or latency guarantee. A conversation stays on its current healthy route regardless of mode. Send the header at most once. Fusion, multi-model cascade, and some multimodal requests reject cheapest and fastest with 400.
Comma-separated allowlist of provider identifiers that may serve the request. Use 1 to 16 distinct case-insensitive names, each 1 to 64 letters, digits, underscores, or hyphens, starting with a letter or digit. The restriction applies under every supported routing mode and on every retry. Invalid values return 400 with code invalid_provider_restriction; a model with no route on a listed provider returns 400 with code no_allowed_provider; listed providers that cannot serve now return 503. Fusion and multi-model cascade requests reject this header with 400.
Request Bodyrequired
Section titled “Request Bodyrequired”The gateway requires model and messages. Additional provider fields are forwarded unchanged.
object
Canonical buyer model id from /v1/models.
Optional maximum output token count. When omitted, the gateway supplies an output bound using published model limits or its configured default.
object
object
object
object
object
object
object
object
Responses
Section titled “Responses”An Anthropic Messages object, or a text/event-stream when stream is true.
object
object
object
object
object
Example
{ "type": "message", "role": "assistant"}Invalid request or an upstream provider 400 response.
object
object
Gateway request identifier.
Example
{ "type": "error"}The API key is missing or invalid.
object
object
Gateway request identifier.
Example
{ "type": "error"}Insufficient prepaid balance. The error message links to the funding page; when the available balance is nonzero it also reports estimated maximum cost and request-sizing guidance.
object
object
Gateway request identifier.
Examples
No available balance
{ "type": "error", "error": { "type": "permission_error", "message": "Your gm balance is empty. Add credits: https://saygm.com/topup" }}Estimated maximum cost exceeds available balance
{ "type": "error", "error": { "type": "permission_error", "message": "This request's estimated maximum cost of $1.01 exceeds your available balance of $0.51. Add credits: https://saygm.com/topup. Try shortening the conversation or attachments, or lowering max output tokens." }}Guardrail block (guardrail_blocked).
OpenAI-shaped gateway error. Image errors after dispatch may also include billing fields at the top level.
object
object
Machine-readable error code. Account request limits use rate_limit_exceeded.
Gateway request identifier.
Settled charge in nano-dollars; present when billing_status is settled.
object
object
Gateway request identifier.
Gemini-shaped gateway error. Billing fields are included after dispatch.
object
object
Gateway request identifier.
Settled charge in nano-dollars; present when billing_status is settled.
Example
{ "billing_status": "settled"}Request body too large (request_too_large).
OpenAI-shaped gateway error. Image errors after dispatch may also include billing fields at the top level.
object
object
Machine-readable error code. Account request limits use rate_limit_exceeded.
Gateway request identifier.
Settled charge in nano-dollars; present when billing_status is settled.
object
object
Gateway request identifier.
Gemini-shaped gateway error. Billing fields are included after dispatch.
object
object
Gateway request identifier.
Settled charge in nano-dollars; present when billing_status is settled.
Example
{ "billing_status": "settled"}Upstream 422 response.
OpenAI-shaped gateway error. Image errors after dispatch may also include billing fields at the top level.
object
object
Machine-readable error code. Account request limits use rate_limit_exceeded.
Gateway request identifier.
Settled charge in nano-dollars; present when billing_status is settled.
object
object
Gateway request identifier.
Gemini-shaped gateway error. Billing fields are included after dispatch.
object
object
Gateway request identifier.
Settled charge in nano-dollars; present when billing_status is settled.
Example
{ "billing_status": "settled"}Account, model, or upstream request limit. OpenAI-shaped account-limit errors use rate_limit_exceeded.
OpenAI-shaped gateway error. Image errors after dispatch may also include billing fields at the top level.
object
object
Machine-readable error code. Account request limits use rate_limit_exceeded.
Gateway request identifier.
Settled charge in nano-dollars; present when billing_status is settled.
object
object
Gateway request identifier.
Gemini-shaped gateway error. Billing fields are included after dispatch.
object
object
Gateway request identifier.
Settled charge in nano-dollars; present when billing_status is settled.
Example
{ "billing_status": "settled"}Headers
Section titled “Headers”Seconds before retrying, when a delay is available.
Gateway internal error (internal_error).
OpenAI-shaped gateway error. Image errors after dispatch may also include billing fields at the top level.
object
object
Machine-readable error code. Account request limits use rate_limit_exceeded.
Gateway request identifier.
Settled charge in nano-dollars; present when billing_status is settled.
object
object
Gateway request identifier.
Gemini-shaped gateway error. Billing fields are included after dispatch.
object
object
Gateway request identifier.
Settled charge in nano-dollars; present when billing_status is settled.
Example
{ "billing_status": "settled"}Upstream connection failure (upstream_connect_failed).
OpenAI-shaped gateway error. Image errors after dispatch may also include billing fields at the top level.
object
object
Machine-readable error code. Account request limits use rate_limit_exceeded.
Gateway request identifier.
Settled charge in nano-dollars; present when billing_status is settled.
object
object
Gateway request identifier.
Gemini-shaped gateway error. Billing fields are included after dispatch.
object
object
Gateway request identifier.
Settled charge in nano-dollars; present when billing_status is settled.
Example
{ "billing_status": "settled"}The credit service, guardrail policy, or model serving is unavailable.
OpenAI-shaped gateway error. Image errors after dispatch may also include billing fields at the top level.
object
object
Machine-readable error code. Account request limits use rate_limit_exceeded.
Gateway request identifier.
Settled charge in nano-dollars; present when billing_status is settled.
object
object
Gateway request identifier.
Gemini-shaped gateway error. Billing fields are included after dispatch.
object
object
Gateway request identifier.
Settled charge in nano-dollars; present when billing_status is settled.
Example
{ "billing_status": "settled"}Headers
Section titled “Headers”Seconds before retrying, when a delay is available.
Upstream timeout (upstream_timeout) or idle stream timeout (upstream_stream_idle_timeout).
OpenAI-shaped gateway error. Image errors after dispatch may also include billing fields at the top level.
object
object
Machine-readable error code. Account request limits use rate_limit_exceeded.
Gateway request identifier.
Settled charge in nano-dollars; present when billing_status is settled.
object
object
Gateway request identifier.
Gemini-shaped gateway error. Billing fields are included after dispatch.
object
object
Gateway request identifier.
Settled charge in nano-dollars; present when billing_status is settled.
Example
{ "billing_status": "settled"}