Sohbet API’sine hızlı başlangıç

OpenAI uyumlu sohbet

Sohbet ve konuşma için tek bir API anahtarı kullanın. İstekler eşzamanlı olarak geri döner; canlı katalog mevcut model adlarını, kimliklerini ve fiyatları listeler.

1. Bir anahtar oluşturun ve kredi ekleyin

Kaydolun veya konsolda oturum açın. API anahtarları → API anahtarı oluştur'u açın, gösterilen anahtarı bir kez kaydedin ve ardından Cüzdan → Kredi ekle'yi açın. Abonelik isteğe bağlıdır. API çağrıları finanse edilen bir kredi bakiyesi gerektirir; anahtar oluşturmak kredi eklemez.

Anahtarı sunucunuzda tutun. Bkz. Kimlik Doğrulama ve Sınırlar.

Yerel ödeme testi

Şerit testi ödemeleri yalnızca korumalı alan kredileri ekler. Gerçek model çağrılarını finanse etmiyorlar. Yerel entegrasyon testi için yönetici, test kullanıcısının API bakiyesini yönetici konsolunda tamamlayabilir. Canlı ödemeler, ödeme onayından sonra API bakiyesini finanse eder.

2. Bir sohbet ve konuşma örneği çalıştırın

Aşağıdaki kodu chat.py olarak kaydedin. Yüklenecek paket olmadan Python 3'in standart kütüphanesini kullanır. GIRLLAB_API_KEY'i ortamınızda ayarlayın ve ardından python chat.py'i çalıştırın.

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"]))

Örnek, bir ücretli metin sohbeti araması ve bir ücretli konuşma aramasından oluşuyor. Sohbet yanıtını, belirteç kullanımını ve konuşma kredilerini yazdırır ve bir MP3 dosyasını kaydeder. Gerçek sohbet kredileri için Kullanım geçmişini kontrol edin. API temel URL'si https://api.coldstart.win'tir; GIRLLAB_API_BASE'i yalnızca başka bir dağıtım için ayarlayın.

3. Başka bir model deneyin

GIRLLAB_CHAT_MODEL'i chat-creative veya chat-fast olarak değiştirin. GIRLLAB_VOICE'i bağımsız olarak değiştirin:

Aşağıdaki tabloda mevcut genel model adları, model kimlikleri ve ses kimlikleri gösterilmektedir.

Canlı model kataloğu · kredi fiyatları

Model kataloğu yükleniyor…

GET /v1/chat/catalog mevcut modelleri, tüm ses kimliklerini ve güncel fiyatları listeler. Sağlayıcının yukarı akış kimlikleri yerine canlı katalogdaki model kimliklerini kullanın. TTS, modelini voice üzerinden seçer; sohbet model parametresini kabul etmez.

Metin sohbeti: OpenAI uyumlu sohbet. Konuşma ve ses kimlikleri: Konuşma ve katalog.

• Faturalandırma ve Krediler: ücretler, geri ödemeler ve bakiye.
• Hata Kodları: kimlik doğrulama, bakiye ve yukarı akış hataları.

Konsolda Sohbet'i de deneyebilirsiniz. Etkileşimli API referansı istek alanlarını listeler.