شروع سریع

در کمتر از ۵ دقیقه اولین درخواست را به یکی از مدل‌ها ارسال کنید. اگر از OpenAI یا Anthropic مهاجرت می‌کنید، راهنمای مهاجرت کوتاه‌تر است.

پیش‌نیاز

Python نسخه ۳٫۹ به بالا یا Node.js نسخه ۱۸ به بالا. برای ابزارهایی مثل Cursor یا Claude Code به راهنمای یکپارچه‌سازی بروید.

گام‌ها

حساب و کلید بسازید
با شماره موبایل ثبت‌نام کنید و اولین کلید را در محیط DEVELOPMENT بسازید. هنگام ساخت کلید دست‌کم یک مدل مجاز انتخاب کنید. کلید فقط یک‌بار نمایش داده می‌شود.
ساخت کلید API
کیف پول را شارژ کنید
بدون موجودی، درخواست‌ها خطای ۴۰۲ می‌گیرند. حداقل مبلغ شارژ در صفحه شارژ کیف پول نمایش داده می‌شود.
صفحه شارژ کیف پول
کلید را در محیط قرار دهید
terminal
```
export DOTHOOSH_API_KEY="dh_test_…"
```
SDK را نصب کنید
از SDK رسمی OpenAI استفاده کنید؛ SDK اختصاصی لازم نیست.
terminal
```
pip install openai
```

اولین درخواست

مقدار model را از کاتالوگ مدل‌ها کپی کنید؛ شناسه‌ها پیشوند ارائه‌دهنده ندارند.

app.py

import os
from openai import OpenAI

client = OpenAI(
    base_url="https://gateway.dothoosh.com/v1",
    api_key=os.environ["DOTHOOSH_API_KEY"],
)

resp = client.chat.completions.create(
    model="deepseek-flash",
    messages=[{"role": "user", "content": "سلام"}],
)
print(resp.choices[0].message.content)

شناسه درخواست و مصرف را ببینید
شناسه درخواست را از هدر پاسخ بخوانید و مصرف را در کنسول ببینید. کنسول مصرف را بر اساس پروژه، کلید، مدل و محیط نشان می‌دهد.
response header
```
x-request-id: …
```