Документация

PostCorporate API совместим с OpenAI API. Поменяйте base URL и ключ — ваш код, SDK или IDE заработает без других изменений.

Quickstart · 2 минуты

1. Получите ключ

Пополните баланс на /buy и возьмите пропуск. Ключ выдаётся сразу после оформления — он на странице /client.

2. Первый запрос

curl https://postcorporate.tech/v1/chat/completions \
  -H "Authorization: Bearer ВАШ_КЛЮЧ" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude-sonnet-5",
    "messages": [
      {"role": "user", "content": "Привет! Расскажи о себе."}
    ]
  }'

from openai import OpenAI

client = OpenAI(
    api_key="ВАШ_КЛЮЧ",
    base_url="https://postcorporate.tech/v1",
)

response = client.chat.completions.create(
    model="claude-sonnet-5",
    messages=[
        {"role": "user", "content": "Привет! Расскажи о себе."}
    ]
)
print(response.choices[0].message.content)

import OpenAI from "openai";

const client = new OpenAI({
  apiKey: "ВАШ_КЛЮЧ",
  baseURL: "https://postcorporate.tech/v1",
});

const response = await client.chat.completions.create({
  model: "claude-sonnet-5",
  messages: [{ role: "user", content: "Привет! Расскажи о себе." }],
});
console.log(response.choices[0].message.content);

Авторизация

Все запросы требуют заголовок Authorization с Bearer-токеном:

Authorization: Bearer ВАШ_КЛЮЧ

Ключ начинается с sk-. Найти его можно на странице /client. Срок действия и остаток баланса также отображаются там.

Модели и цены

Цены в долларах за 1 000 000 токенов. Чтение из кеша — 50% от цены входа.

Полный список доступных моделей: GET /v1/models

Chat Completions

POST /v1/chat/completions — основной эндпоинт. Полностью совместим с OpenAI Chat API.

Параметры запроса

Пример ответа

{
  "id": "chatcmpl-abc123",
  "object": "chat.completion",
  "created": 1785765000,
  "model": "claude-sonnet-5",
  "choices": [{
    "index": 0,
    "message": {
      "role": "assistant",
      "content": "Привет! Я языковая модель Claude Sonnet 5…"
    },
    "finish_reason": "stop"
  }],
  "usage": {
    "prompt_tokens": 18,
    "completion_tokens": 45,
    "total_tokens": 63
  }
}

Streaming

Передайте "stream": true — ответ придёт частями в формате Server-Sent Events.

curl https://postcorporate.tech/v1/chat/completions \
  -H "Authorization: Bearer ВАШ_КЛЮЧ" \
  -H "Content-Type: application/json" \
  -d '{"model":"claude-sonnet-5","messages":[{"role":"user","content":"Привет"}],"stream":true}'

stream = client.chat.completions.create(
    model="claude-sonnet-5",
    messages=[{"role": "user", "content": "Расскажи мне историю"}],
    stream=True,
)
for chunk in stream:
    if chunk.choices[0].delta.content:
        print(chunk.choices[0].delta.content, end="", flush=True)

Формат chunk

data: {"id":"chatcmpl-xyz","object":"chat.completion.chunk","choices":[{"delta":{"content":"Привет"},"index":0}]}

data: [DONE]

Изображения (Vision)

Модели с поддержкой изображений принимают content как массив:

{
  "model": "claude-sonnet-5",
  "messages": [{
    "role": "user",
    "content": [
      {"type": "image_url", "image_url": {"url": "https://example.com/img.jpg"}},
      {"type": "text", "text": "Что на этом изображении?"}
    ]
  }]
}

Поддерживаются JPEG, PNG, GIF, WebP. Максимум 20 МБ. Также работает base64: "url": "data:image/jpeg;base64,..."

Какие модели поддерживают изображения — смотрите в таблице выше (столбец Картинки).

Коды ошибок

Формат ошибки

{
  "error": {
    "message": "Описание ошибки на русском",
    "type": "rate_limit_error",
    "code": 429
  }
}

Retry: рекомендуемый алгоритм

import time, random

def call_with_retry(fn, max_retries=3):
    for attempt in range(max_retries):
        try:
            return fn()
        except Exception as e:
            if attempt == max_retries - 1: raise
            status = getattr(e, "status_code", 0)
            if status in (429, 500, 503):
                delay = (2 ** attempt) + random.uniform(0, 1)
                time.sleep(delay)
            else:
                raise  # 4xx кроме 429 — не ретраить

Лимиты

SDK и IDE

Используйте стандартные OpenAI SDK — меняется только base_url и api_key.

FAQ