البدء السريع مع Chat API

دردشة متوافقة مع OpenAI

استخدم مفتاح API واحدًا للدردشة والكلام. طلبات العودة بشكل متزامن. يسرد الكتالوج المباشر أسماء النماذج والمعرفات والأسعار الحالية.

1. أنشئ مفتاحًا وأضف الاعتمادات

قم بالتسجيل أو تسجيل الدخول إلى وحدة التحكم. افتح مفاتيح 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 الأساسي لواجهة برمجة التطبيقات هو 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. معرفات الكلام والصوت: الكلام والكتالوج.

• الفواتير والائتمانات: الرسوم والمبالغ المستردة والرصيد.
• رموز الأخطاء: المصادقة والتوازن وأخطاء المنبع.

يمكنك أيضًا تجربة الدردشة في وحدة التحكم. يسرد مرجع واجهة برمجة التطبيقات التفاعلية حقول الطلب.