AI Gateway API

Authentication

Most requests require a Bearer token. Pass your API or SDK key in the Authorization header. Public endpoints are noted below and do not require authentication.

You can find your SDK key in the Agentuity Console under your project settings.

List Models

List model metadata for LLM providers available through AI Gateway, grouped by provider.

Authentication: Public. No auth required.

Response

JSON response with provider keys mapped to arrays of supported model metadata under the data envelope.

Response Fields

Example

curl -X GET 'https://aigateway-usw.agentuity.cloud/models' \
  -H 'Authorization: Bearer $AGENTUITY_SDK_KEY'

Create Completion

Create a completion through the AI Gateway auto-router. The gateway routes by model and request shape, so chat messages and legacy prompt payloads are both supported.

Request Body

Completion request. Use messages for chat-compatible models and prompt for legacy OpenAI completions-compatible models. Additional provider-specific fields are passed through.

Response

Provider-compatible completion response.

Response Headers

Response Fields

Example

curl -X POST 'https://aigateway-usw.agentuity.cloud/' \
  -H 'Authorization: Bearer $AGENTUITY_SDK_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
  "model": "openai/gpt-4o-mini",
  "messages": [
    {
      "role": "user",
      "content": "Say hello in one sentence."
    }
  ],
  "max_tokens": 64
}'

Stream Completion

Create a streaming completion through the AI Gateway auto-router. Set stream: true to receive Server-Sent Events token deltas.

Request Body

Completion request with stream set to true.

Response

Server-Sent Events stream. Each data: frame contains a provider-compatible delta payload. The stream ends with data: [DONE].

Response Headers

Response Fields

Example

curl -X POST 'https://aigateway-usw.agentuity.cloud/' \
  -H 'Authorization: Bearer $AGENTUITY_SDK_KEY' \
  -H 'Accept: text/event-stream' \
  -H 'Content-Type: application/json' \
  -d '{
  "model": "openai/gpt-4o-mini",
  "messages": [
    {
      "role": "user",
      "content": "Count to three."
    }
  ],
  "stream": true
}'