Codex Pool — External API

Базовый URL: · OpenAPI · Admin UI · /health · /v1/status

Авторизация

Для POST /v1/exec нужен API key. Передайте один из заголовков:

Authorization: Bearer <TOKEN>
X-Pool-Token: <TOKEN>

Токен хранится только в браузере (localStorage), на сервер страницы не уходит, кроме тестового запроса.

Эндпоинты

Метод	Путь	Auth	Назначение
GET	/health	нет	Health check
GET	/v1/status	нет	Число healthy-аккаунтов, mode
POST	/v1/exec	да	Выполнить промпт через пул
GET	/docs	нет	Эта страница
GET	/openapi.json	нет	OpenAPI 3 schema

Быстрый тест

API token (не сохраняется на сервере) Prompt project

—

—

curl

curl -sS -X POST "$CODEX_POOL_URL/v1/exec" \
  -H "Authorization: Bearer $CODEX_POOL_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"prompt":"Ответь одним словом: pong","project":"demo","timeout":60}'

Python

import os, requests

url = os.environ["CODEX_POOL_URL"].rstrip("/") + "/v1/exec"
token = os.environ["CODEX_POOL_TOKEN"]
r = requests.post(
    url,
    headers={"Authorization": f"Bearer {token}"},
    json={"prompt": "Ответь одним словом: pong", "project": "demo", "timeout": 60},
    timeout=90,
)
print(r.status_code, r.json())

Полная инструкция: docs/EXTERNAL.md в репозитории.