Codex

Stream a Codex subscription response

Forward the official Codex client’s native request to the fixed OpenAI Codex backend using its ChatGPT token. The separate personal Aixy key selects the authorized project and user. Supports HTTP SSE with supports_websockets=false in Codex configuration. Native history, tool identifiers, encrypted reasoning and streaming events are preserved. Activity records billing_channel=subscription, reported usage and no API cost. ChatGPT limits and credits still apply. This route provides no cross-provider translation, fallback or subscription pooling.

POST

backend-api

codex

responses

Stream a Codex subscription response

curl --request POST \
  --url https://api.aixy-gateway.com/backend-api/codex/responses \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --header 'X-Gateway-Key: <api-key>' \
  --data '
{
  "model": "native-model-id",
  "input": [
    {
      "role": "user",
      "content": [
        {
          "type": "input_text",
          "text": "Hello"
        }
      ]
    }
  ],
  "stream": true,
  "store": false
}
'

import requests

url = "https://api.aixy-gateway.com/backend-api/codex/responses"

payload = {
    "model": "native-model-id",
    "input": [
        {
            "role": "user",
            "content": [
                {
                    "type": "input_text",
                    "text": "Hello"
                }
            ]
        }
    ],
    "stream": True,
    "store": False
}
headers = {
    "X-Gateway-Key": "<api-key>",
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {
    'X-Gateway-Key': '<api-key>',
    Authorization: 'Bearer <token>',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    model: 'native-model-id',
    input: [{role: 'user', content: [{type: 'input_text', text: 'Hello'}]}],
    stream: true,
    store: false
  })
};

fetch('https://api.aixy-gateway.com/backend-api/codex/responses', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

event: response.created
data: {"type":"response.created","response":{"id":"resp_example"}}

event: response.output_text.delta
data: {"type":"response.output_text.delta","delta":"Hello"}

event: response.completed
data: {"type":"response.completed","response":{"id":"resp_example","usage":{"input_tokens":10,"output_tokens":1,"total_tokens":11}}}

{
  "error": {
    "code": "invalid_gateway_api_key",
    "message": "Gateway API key is invalid or revoked"
  }
}

{
  "error": {
    "code": "invalid_gateway_api_key",
    "message": "Gateway API key is invalid or revoked"
  }
}

{
  "error": {
    "code": "invalid_gateway_api_key",
    "message": "Gateway API key is invalid or revoked"
  }
}

{
  "error": {
    "code": "invalid_gateway_api_key",
    "message": "Gateway API key is invalid or revoked"
  }
}

{
  "error": {
    "code": "invalid_gateway_api_key",
    "message": "Gateway API key is invalid or revoked"
  }
}

{
  "error": {
    "code": "invalid_gateway_api_key",
    "message": "Gateway API key is invalid or revoked"
  }
}

{
  "error": {
    "code": "invalid_gateway_api_key",
    "message": "Gateway API key is invalid or revoked"
  }
}

{
  "error": {
    "code": "invalid_gateway_api_key",
    "message": "Gateway API key is invalid or revoked"
  }
}

{
  "error": {
    "code": "invalid_gateway_api_key",
    "message": "Gateway API key is invalid or revoked"
  }
}

{
  "error": {
    "code": "invalid_gateway_api_key",
    "message": "Gateway API key is invalid or revoked"
  }
}

{}

Authorizations

X-Gateway-Key

string

header

required

The caller's personal, project-scoped Aixy key. Aixy validates and removes this header before forwarding. It does not replace the ChatGPT token.

Authorization

string

header

required

The user's ChatGPT access token supplied by the official Codex client. Forwarded only to the fixed Codex backend; never stored as a connection.

Headers

X-Request-ID

string

Optional caller-generated request identifier for end-to-end tracing.

Maximum string length: 255

X-Aixy-Session-ID

string

Optional opaque conversation identifier recorded in Activity metadata. Reuse it for every call in a conversation. Sessions are isolated by organization, project, user and API key. Use no personal data or secrets. Invalid values are ignored. The header is not forwarded, grants no permissions and does not change routing affinity.

Required string length: 1 - 128

Pattern: ^[A-Za-z0-9._:-]+$

Example:

"conversation-82"

ChatGPT-Account-ID

string

Account/workspace selected by Codex; preserved for OpenAI validation. It does not select or authorize an Aixy tenant.

Body

application/json

model

string

required

Native Codex model slug, without an Aixy provider prefix.

input

object[]

required

Native conversation history, tool items and opaque reasoning state.

stream

boolean

required

store

boolean

required

Response

Incremental native SSE. A successful stream ends with response.completed; errors can occur after headers or text arrive.

The response is of type string.

Stream a Codex subscription response

curl --request POST \
  --url https://api.aixy-gateway.com/backend-api/codex/responses \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --header 'X-Gateway-Key: <api-key>' \
  --data '
{
  "model": "native-model-id",
  "input": [
    {
      "role": "user",
      "content": [
        {
          "type": "input_text",
          "text": "Hello"
        }
      ]
    }
  ],
  "stream": true,
  "store": false
}
'

import requests

url = "https://api.aixy-gateway.com/backend-api/codex/responses"

payload = {
    "model": "native-model-id",
    "input": [
        {
            "role": "user",
            "content": [
                {
                    "type": "input_text",
                    "text": "Hello"
                }
            ]
        }
    ],
    "stream": True,
    "store": False
}
headers = {
    "X-Gateway-Key": "<api-key>",
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {
    'X-Gateway-Key': '<api-key>',
    Authorization: 'Bearer <token>',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    model: 'native-model-id',
    input: [{role: 'user', content: [{type: 'input_text', text: 'Hello'}]}],
    stream: true,
    store: false
  })
};

fetch('https://api.aixy-gateway.com/backend-api/codex/responses', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

event: response.created
data: {"type":"response.created","response":{"id":"resp_example"}}

event: response.output_text.delta
data: {"type":"response.output_text.delta","delta":"Hello"}

event: response.completed
data: {"type":"response.completed","response":{"id":"resp_example","usage":{"input_tokens":10,"output_tokens":1,"total_tokens":11}}}

{
  "error": {
    "code": "invalid_gateway_api_key",
    "message": "Gateway API key is invalid or revoked"
  }
}

{
  "error": {
    "code": "invalid_gateway_api_key",
    "message": "Gateway API key is invalid or revoked"
  }
}

{
  "error": {
    "code": "invalid_gateway_api_key",
    "message": "Gateway API key is invalid or revoked"
  }
}

{
  "error": {
    "code": "invalid_gateway_api_key",
    "message": "Gateway API key is invalid or revoked"
  }
}

{
  "error": {
    "code": "invalid_gateway_api_key",
    "message": "Gateway API key is invalid or revoked"
  }
}

{
  "error": {
    "code": "invalid_gateway_api_key",
    "message": "Gateway API key is invalid or revoked"
  }
}

{
  "error": {
    "code": "invalid_gateway_api_key",
    "message": "Gateway API key is invalid or revoked"
  }
}

{
  "error": {
    "code": "invalid_gateway_api_key",
    "message": "Gateway API key is invalid or revoked"
  }
}

{
  "error": {
    "code": "invalid_gateway_api_key",
    "message": "Gateway API key is invalid or revoked"
  }
}

{
  "error": {
    "code": "invalid_gateway_api_key",
    "message": "Gateway API key is invalid or revoked"
  }
}

{}

Codex

OpenAI

Decisions

Anthropic

Models

Stream a Codex subscription response

Authorizations

Headers

Body

Response