API v1 · Online

Подключите любой AI‑клиент

Claude Code, расширения VS Code и существующие OpenAI- или Anthropic-приложения работают через единый ключ Emerald.

https://emeraldai.sbs
Claude CodeVS CodeTool callingStreaming SSEOpenAI compatibleAnthropic compatible
3 ШАГА

Быстрый старт

01

Создайте ключ

Откройте кабинет и выпустите API-ключ для своего приложения.

02

Выберите формат

OpenAI Chat Completions или Anthropic Messages — оба работают через API v1.

03

Отправьте запрос

Укажите публичный ID модели. Расход вернётся в ответе и заголовках.

БЕЗОПАСНОСТЬ

Авторизация

Не размещайте ключ в браузерном JavaScript и публичных репозиториях. Передавайте его с серверной стороны одним из способов:

HTTP headers
Authorization: Bearer sk-em-••••••••
# Anthropic-совместимый вариант
x-api-key: sk-em-••••••••
anthropic-version: 2023-06-01
Ключ можно скопировать позже. В кабинете он хранится в зашифрованном виде. Если ключ скомпрометирован — отзовите его и создайте новый.
API V1

Endpoints

GET/v1/modelsКаталог доступных моделей
GET/v1/accountБаланс и статистика аккаунта
POST/v1/chat/completionsOpenAI Chat Completions
POST/v1/images/generationsGPT Image 2 · генерация изображений
POST/v1/messagesAnthropic Messages
POST/v1/messages/count_tokensОценка контекста для Claude Code
OPENAI IMAGES API

GPT Image 2

POST/v1/images/generations

Endpoint совместим с OpenAI Images API: передайте model, prompt, размер и качество. Emerald возвращает изображение в data[0].b64_json и списывает фиксированные 400 000 токенов только после успешной генерации.

Python · openai
from base64 import b64decode
from openai import OpenAI

client = OpenAI(
    api_key="sk-em-...",
    base_url="https://emeraldai.sbs/v1",
)

result = client.images.generate(
    model="gpt-image-2",
    prompt="Изумрудный мегаполис на рассвете",
    size="1024x1024",
    quality="medium",
)

with open("emerald.webp", "wb") as image_file:
    image_file.write(b64decode(result.data[0].b64_json))
cURL
curl https://emeraldai.sbs/v1/images/generations \
  -H "Authorization: Bearer sk-em-..." \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-image-2",
    "prompt": "Изумрудный мегаполис на рассвете",
    "size": "1024x1024",
    "quality": "medium",
    "output_format": "webp"
  }'
Поддерживаемые параметры: n=1, quality=auto|low|medium|high, output_format=png|jpeg|webp, background=auto|opaque|transparent. Для прозрачного фона используйте PNG или WEBP.
ГОТОВЫЕ КЛИЕНТЫ

Выберите, что подключаете

Для CLI и агентных расширений поддерживаются tool calls, результаты инструментов и потоковые ответы.

⌘
Claude CodeCLI · Anthropic API
2 минуты → { }
VS CodeCline · Continue
3 минуты → ›_
ДругиеRoo Code · SDK · cURL
Открыть →
CLAUDE CODE CLI

Claude Code через Emerald

Claude Code умеет работать через LLM gateway. Укажите базовый URL без /v1, ключ Emerald и публичный ID модели.

Поддержано в API:MessagesStreamingtool_use / tool_resultcount_tokens

macOS / Linux / WSL

Terminal · Bash / Zsh
npm install -g @anthropic-ai/claude-code

export ANTHROPIC_BASE_URL="https://emeraldai.sbs"
export ANTHROPIC_AUTH_TOKEN="sk-em-..."
export ANTHROPIC_MODEL="claude-sonnet-5"
export ANTHROPIC_DEFAULT_OPUS_MODEL="claude-opus-5"
export ANTHROPIC_DEFAULT_SONNET_MODEL="claude-sonnet-5"
export ANTHROPIC_DEFAULT_HAIKU_MODEL="deepseek-v4-flash"
export CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY=1

claude --model claude-sonnet-5

Windows PowerShell

PowerShell
$env:ANTHROPIC_BASE_URL = "https://emeraldai.sbs"
$env:ANTHROPIC_AUTH_TOKEN = "sk-em-..."
$env:ANTHROPIC_MODEL = "claude-sonnet-5"
$env:ANTHROPIC_DEFAULT_OPUS_MODEL = "claude-opus-5"
$env:ANTHROPIC_DEFAULT_SONNET_MODEL = "claude-sonnet-5"
$env:ANTHROPIC_DEFAULT_HAIKU_MODEL = "deepseek-v4-flash"
$env:CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY = "1"

claude --model claude-sonnet-5
Модели появятся в /model. Discovery получает каталог через GET /v1/models, а переменные ANTHROPIC_DEFAULT_* привязывают встроенные алиасы opus, sonnet и haiku к профилям Emerald. ANTHROPIC_AUTH_TOKEN отправляется как Bearer‑ключ. Не сохраняйте ключ в репозитории.
VS CODE

Cline и Continue

Сам VS Code не выбирает API‑провайдера. Установите агентное расширение и укажите OpenAI‑совместимый URL Emerald.

C

Cline

Визуальная настройка
  1. Откройте Cline → Settings
  2. API Provider: OpenAI Compatible
  3. Base URL: https://emeraldai.sbs/v1
  4. API Key: sk-em-...
  5. Model ID: claude-sonnet-5
↗

Continue

config.yaml
YAML
name: Emerald AI
version: 0.0.1
schema: v1
models:
  - name: Emerald Sonnet
    provider: openai
    model: claude-sonnet-5
    apiBase: https://emeraldai.sbs/v1
    apiKey: sk-em-...
    roles: [chat, edit, apply]
OPENAI COMPATIBLE

Roo Code, свои приложения и SDK

Roo Code / другие агенты

Выберите провайдера OpenAI Compatible, URL https://emeraldai.sbs/v1, ключ Emerald и любой ID из каталога.

OpenAI SDK

base_url="https://emeraldai.sbs/v1" и обычный Bearer‑ключ. Поддерживаются streaming и function calling.

Anthropic SDK

base_url="https://emeraldai.sbs" и ключ через api_key. Поддерживаются Messages и tools.

OPENAI SDK

Chat Completions

POST/v1/chat/completions
Python · openai
from openai import OpenAI

client = OpenAI(
    api_key="sk-em-...",
    base_url="https://emeraldai.sbs/v1",
)

response = client.chat.completions.create(
    model="claude-fable-5",
    messages=[{"role": "user", "content": "Привет!"}],
)

print(response.choices[0].message.content)
print(response.usage.total_tokens)
ANTHROPIC SDK

Messages

POST/v1/messages
Python · anthropic
from anthropic import Anthropic

client = Anthropic(
    api_key="sk-em-...",
    base_url="https://emeraldai.sbs",
)

message = client.messages.create(
    model="gemini-3-1-pro",
    max_tokens=1024,
    messages=[{"role": "user", "content": "Привет!"}],
)

print(message.content[0].text)
print(message.usage.output_tokens)
БЕЗ SDK

Запрос через cURL

Terminal
curl https://emeraldai.sbs/v1/chat/completions \
  -H "Authorization: Bearer sk-em-..." \
  -H "Content-Type: application/json" \
  -d '{
    "model": "qwen-3-6",
    "messages": [{"role": "user", "content": "Привет!"}]
  }'
SSE

Потоковые ответы

Передайте stream=true. Сервер вернёт события Server-Sent Events и завершит поток маркером, совместимым с выбранным SDK.

OpenAI

Получайте части текста из choices[0].delta.content.

Anthropic

Обрабатывайте события content_block_delta и итоговый message_stop.

Agent tools: в Anthropic-формате используйте блоки tool_use и tool_result; в OpenAI-формате — tools и tool_calls. Emerald преобразует оба формата и сохраняет списание по фактическому usage.
КАТАЛОГ

Модели и коэффициенты

Публичный ID стабилен. Коэффициент показывает, сколько токенов баланса будет списано за один фактический токен запроса и ответа.

claude-fable-5-1Claude FABLE 5.1×14
claude-fable-5Claude FABLE 5×11
gpt-6-astraGPT 6 Astra×12
gpt-6-1-solGPT 6.1 SOL×6
gpt-6-solGPT 6 SOL×5
claude-opus-5-5Claude Opus 5.5×8
claude-sonnet-5-5Claude Sonnet 5.5×4
claude-haiku-4-5Claude Haiku 4.5×1.5
gemini-3-8-flashGemini 3.8 Flash×3
gemini-3-5-flash-liteGemini 3.5 Flash Lite×1
gemini-3-1-proGemini 3.1 Pro×3
gpt-5-6-solGPT 5.6 SOL×7
gpt-5-6-terraGPT 5.6 Terra×1
gpt-5-6-lunaGPT 5.6 Luna×1
claude-opus-5Claude Opus 5×5
grok-4-6GROK 4.6×4
grok-4-5GROK 4.5×3
claude-opus-4-8Claude Opus 4.8×5
gpt-5-5GPT 5.5×1
claude-sonnet-5Claude Sonnet 5×3.5
claude-opus-4-6Claude Opus 4.6×2
deepseek-v4-proDeepSeek V4 Pro×1.5
deepseek-v4-1-flashDeepSeek V4.1 Flash×1
glm-5-3-flashGLM 5.3 Flash×3
kimi-k3Kimi K3×5
qwen-3-6Qwen 3.6×3
qwen-3-8-maxQwen 3.8 MAX×6
gemini-3-7-flashGemini 3.7 Flash×4
gemini-3-6-flashGemini 3.6 Flash×3
ox-alphaOX Alpha×0.2
minimax-m3MiniMax M3×1.5
gpt-5-4-miniGPT 5.4 mini×2.5
step-3-7-flashStep 3.7 Flash×0.6
deepseek-v4-flashDeepSeek V4 Flash×0.8
nemotron-freeNemotron (FREE)×0
gpt-image-2GPT Image 2400 000 / фото
USAGE

Баланс и списание

GET/v1/account

Текстовые модели: ceil((input_tokens + output_tokens) × multiplier). Генерация GPT Image 2 списывает фиксированные 400 000 токенов за успешно созданное изображение.

Точный расход приходит в объекте billing, стандартном объекте usage и заголовке x-emerald-charged-tokens. В api_key_limits ответа /v1/account доступны дневной лимит запросов, месячный лимит токенов и текущий расход выбранного ключа. Лимиты настраиваются отдельно для каждого ключа в кабинете; значение 0 означает без ограничений.
ДИАГНОСТИКА

Коды ошибок

Ответ всегда содержит JSON-объект error. Машиночитаемый код также доступен в заголовке x-emerald-error-code.

HTTPКодЧто делать
400invalid_requestПроверьте JSON, модель и обязательные поля.
401invalid_api_keyПроверьте ключ и заголовок авторизации.
402insufficient_balanceНедостаточно токенов на балансе.
403account_bannedДоступ аккаунта или адреса заблокирован.
429api_key_limit_exceededИсчерпан дневной или месячный лимит этого ключа. Тип лимита указан в x-emerald-limit-type.
503upstream_unavailableПровайдер временно недоступен; повторите с задержкой.