Быстрый старт с Chat API

Чат, совместимый с OpenAI

Используйте один ключ API для чата и речи. Запросы возвращаются синхронно; в живом каталоге указаны текущие названия моделей, их идентификаторы и цены.

1. Создайте ключ и добавьте кредиты

Зарегистрируйтесь или войдите в консоль. Откройте Ключи API → Создать ключ API, сохраните указанный ключ один раз, затем откройте Кошелек → Добавить кредиты. Подписка не является обязательной. Для вызовов API требуется пополненный кредитный баланс; создание ключа не добавляет кредитов.

Храните ключ на своем сервере. См. Аутентификация и ограничения.

Локальное тестирование платежей

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

2. Пример запуска чата и речи

Сохраните приведенный ниже код как chat.py. Он использует стандартную библиотеку Python 3 без каких-либо пакетов для установки. Установите GIRLLAB_API_KEY в своей среде, затем запустите python chat.py.

macOS / Linux

export GIRLLAB_API_KEY='sk-your-key'
python3 chat.py

Windows PowerShell

$env:GIRLLAB_API_KEY = 'sk-your-key'
python chat.py

import base64
import json
import os
from pathlib import Path
from urllib.error import HTTPError
from urllib.request import Request, urlopen

BASE = os.environ.get("GIRLLAB_API_BASE", "https://api.coldstart.win").rstrip("/")
KEY = os.environ["GIRLLAB_API_KEY"]
MODEL = os.environ.get("GIRLLAB_CHAT_MODEL")
VOICE = os.environ.get("GIRLLAB_VOICE")

def api(path, body=None):
    request = Request(
        BASE + path,
        data=json.dumps(body).encode() if body is not None else None,
        headers={"Authorization": "Bearer " + KEY,
                 "Content-Type": "application/json"},
    )
    try:
        with urlopen(request, timeout=90) as response:
            return json.load(response)
    except HTTPError as error:
        raise SystemExit(f"HTTP {error.code}: {error.read().decode()}")

catalog = api("/v1/chat/catalog")
MODEL = MODEL or catalog["defaultModel"]
VOICE = VOICE or catalog["defaultVoice"]
model = next((m for m in catalog["models"] if m["id"] == MODEL), None)
voice = next((v for v in catalog["voices"] if v["id"] == VOICE), None)
if not model or not model["available"] or not voice or not voice["available"]:
    raise SystemExit("Choose an available model and voice from /v1/chat/catalog.")

reply = api("/v1/chat/completions", {
    "model": MODEL,
    "messages": [
        {"role": "system", "content": "You are a friendly assistant."},
        {"role": "user", "content": "Say hello in one short sentence."},
    ],
    "max_tokens": 64,
})
print(json.dumps(reply, ensure_ascii=False, indent=2))
# For another turn, append the assistant reply and the next user message to messages.
print(reply["choices"][0]["message"]["content"])

speech = api("/v1/chat/speech", {"text": "Hello.", "voice": VOICE})
header, encoded = speech["audio"].split(",", 1)
file = Path("speech.mp3")
file.write_bytes(base64.b64decode(encoded))
print("Saved", file, "— speech billing:", json.dumps(speech["billing"]))

В примере выполняется один платный вызов текстового чата и один платный речевой вызов. Он печатает ответ чата, информацию об использовании токена и речевых кредитах, а также сохраняет файл MP3. Проверьте историю использования, чтобы узнать о фактических кредитах чата. Базовый URL-адрес API — https://api.coldstart.win; установите GIRLLAB_API_BASE только для другого развертывания.

3. Попробуйте другую модель

Измените GIRLLAB_CHAT_MODEL на chat-creative или chat-fast. Измените GIRLLAB_VOICE самостоятельно:

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

Каталог живых моделей · цены в кредит

Загрузка каталога моделей…

GET /v1/chat/catalog перечисляет доступные модели, все голосовые идентификаторы и текущие цены. Используйте идентификаторы моделей из действующего каталога, а не исходные идентификаторы поставщика. TTS выбирает свою модель через voice; он не принимает параметр чата model.

Текстовый чат: Чат, совместимый с OpenAI. Речевые и голосовые идентификаторы: Речь и каталог.

• Счета и кредиты: сборы, возвраты и баланс.
• Коды ошибок: ошибки аутентификации, баланса и восходящего потока.

Вы также можете попробовать Чат в консоли. В интерактивном справочнике API перечислены поля запроса.