Начало работы

Spectra API совместим с OpenAI SDK. Вы можете использовать знакомые библиотеки на Python, JavaScript и других языках, просто указав наш base URL.

Аутентификация

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

API-ключи можно создать и управлять ими на странице API-ключей. Никогда не передавайте ключи в клиентском коде или публичных репозиториях.

Chat Completions

Генерация текстовых ответов на основе диалога. Поддерживает стриминг, function calling и structured output.

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

Примеры

from openai import OpenAI

client = OpenAI(
    api_key="sk-your-api-key",
    base_url="https://api.spectra.ai/v1"
)

response = client.chat.completions.create(
    model="gpt-5.5",
    messages=[
        {"role": "system", "content": "Ты полезный ассистент."},
        {"role": "user", "content": "Привет! Расскажи о квантовых компьютерах."}
    ],
    temperature=0.7,
    max_tokens=1000
)

print(response.choices[0].message.content)

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

{
  "id": "chatcmpl-abc123",
  "object": "chat.completion",
  "created": 1700000000,
  "model": "gpt-5.5",
  "choices": [
    {
      "index": 0,
      "message": {
        "role": "assistant",
        "content": "Привет! Квантовые компьютеры — это..."
      },
      "finish_reason": "stop"
    }
  ],
  "usage": {
    "prompt_tokens": 25,
    "completion_tokens": 150,
    "total_tokens": 175
  }
}

Генерация изображений

Создание изображений по текстовому описанию. Поддерживает DALL-E 3, Stable Diffusion и другие модели.

response = client.images.generate(
    model="dall-e-3",
    prompt="Закат над горами в стиле импрессионизма",
    size="1024x1024",
    quality="hd",
    n=1
)

image_url = response.data[0].url
print(image_url)

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

{
  "created": 1700000000,
  "data": [
    {
      "url": "https://api.spectra.ai/v1/storage/image/abc123.png",
      "revised_prompt": "Закат над горными вершинами..."
    }
  ]
}

Аудио / TTS

Синтез речи (Text-to-Speech) и транскрипция аудио.

Синтез речи

response = client.audio.speech.create(
    model="tts-1-hd",
    voice="nova",
    input="Привет! Это синтез речи через Spectra API."
)

response.stream_to_file("output.mp3")

Эмбеддинги

Получение векторных представлений текста для семантического поиска, кластеризации и классификации.

response = client.embeddings.create(
    model="text-embedding-3-small",
    input="Поисковый запрос: лучшие рестораны Москвы"
)

embedding = response.data[0].embedding
print(f"Размерность: {len(embedding)}")

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

{
  "object": "list",
  "data": [
    {
      "object": "embedding",
      "index": 0,
      "embedding": [0.0023, -0.009, 0.015, ...]
    }
  ],
  "model": "text-embedding-3-small",
  "usage": {
    "prompt_tokens": 8,
    "total_tokens": 8
  }
}

Модели

Список доступных моделей и их стоимость.

* Цены ориентировочные и могут отличаться. Актуальные цены доступны на странице тарифов.

Rate Limits

Лимиты запросов устанавливаются для каждого API-ключа. По умолчанию лимит составляет 60 запросов в минуту (RPM).

При превышении лимита API вернёт 429 Too Many Requests. Используйте экспоненциальный backoff для автоматических повторов.

Коды ошибок

API использует стандартные HTTP-коды статуса и возвращает JSON с описанием ошибки.

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

{
  "error": {
    "message": "Недостаточно средств на балансе",
    "type": "insufficient_balance",
    "code": "402",
    "param": null
  }
}