ДокументацияНачало работыБыстрый старт

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

Создайте API-ключ и сделайте первый вызов за несколько минут в любом диалекте.

Эта страница проведёт вас через минимальную рабочую интеграцию: создать ключ → отправить первый запрос → посмотреть статистику.

Шаг 1: создайте API-ключ

Зарегистрируйтесь, войдите в консоль и создайте ключ на странице «API Key». Ключи имеют вид sk-sole-….

Полный ключ показывается только один раз при создании; сервер хранит лишь хеш. Сразу сохраните его в менеджер секретов или переменную окружения — при утере придётся создать новый.

Шаг 2: первый вызов (совместимый с OpenAI)

Рекомендуем начать с Responses API — тот же вход, которым пользуются инструменты вроде Codex:

bash

curl https://api.soleapi.com/v1/responses \
  -H "Authorization: Bearer $SOLEAPI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude-fable-5",
    "input": "Say hello in one sentence"
  }'

python

from openai import OpenAI

client = OpenAI(
    api_key="sk-sole-...",
    base_url="https://api.soleapi.com/v1",
)

resp = client.responses.create(
    model="claude-fable-5",
    input="Say hello in one sentence",
)
print(resp.output_text)

javascript

import OpenAI from 'openai'

const client = new OpenAI({
  apiKey: 'sk-sole-...',
  baseURL: 'https://api.soleapi.com/v1',
})

const resp = await client.responses.create({
  model: 'claude-fable-5',
  input: 'Say hello in one sentence',
})
console.log(resp.output_text)

Формат Anthropic (Messages API)

Если вы используете Anthropic SDK или Claude Code, вызывайте /v1/messages с заголовком x-api-key:

bash

curl https://api.soleapi.com/v1/messages \
  -H "x-api-key: $SOLEAPI_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude-fable-5",
    "max_tokens": 1024,
    "messages": [{"role": "user", "content": "Say hello in one sentence"}]
  }'

python

import anthropic

client = anthropic.Anthropic(
    api_key="sk-sole-...",
    base_url="https://api.soleapi.com",
)

msg = client.messages.create(
    model="claude-fable-5",
    max_tokens=1024,
    messages=[{"role": "user", "content": "Say hello in one sentence"}],
)
print(msg.content[0].text)

Формат Gemini

С Google GenAI SDK используйте эндпоинты /v1beta и заголовок x-goog-api-key:

bash

curl "https://api.soleapi.com/v1beta/models/gemini-2.5-pro:generateContent" \
  -H "x-goog-api-key: $SOLEAPI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "contents": [{"parts": [{"text": "Say hello in one sentence"}]}]
  }'

python

from google import genai

client = genai.Client(
    api_key="sk-sole-...",
    http_options={"base_url": "https://api.soleapi.com"},
)

resp = client.models.generate_content(
    model="gemini-2.5-pro",
    contents="Say hello in one sentence",
)
print(resp.text)

Диалект Gemini не принимает ключ через параметр ?key= — только в заголовке x-goog-api-key. См. Аутентификацию.

Шаг 3: статистика и счета

В консоли видны текущий баланс, тренды использования, статистика по ключам и детали каждого запроса. О тарификации — в разделе Биллинг и баланс.

Дальнейшие шаги

Стриминг: SSE во всех трёх диалектах.
Обработка ошибок и повторы: устойчивость к 429 и сбоям источников.
Справочник API: поля и форматы ответов каждого эндпоинта.