اولین پاسخ در چند خط
در پنل یک کلید بسازید، از فهرست مدلها یک Model ID فعال بردارید و آن را جای devura-model-id بگذارید. برای API پولی، کیف پول باید اعتبار کافی داشته باشد.
curl https://api.devura.me/v1/chat/completions \
-H "Authorization: Bearer $DEVURA_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: 8bc97926-a13c-4d01-bf8b-3e49c84b345a" \
-d '{"model":"devura-model-id","messages":[{"role":"user","content":"Write a TypeScript debounce function."}],"max_tokens":512}'
Python · OpenAI SDK
import os
from openai import OpenAI
client = OpenAI(
api_key=os.environ["DEVURA_API_KEY"],
base_url="https://api.devura.me/v1",
max_retries=0,
)
response = client.chat.completions.create(
model="devura-model-id",
messages=[{"role": "user", "content": "Explain this code."}],
max_tokens=512,
)
print(response.choices[0].message.content)
کلید دوورا؛ نه کلید ارائهدهنده
هدر Authorization: Bearer الزامی است. کلیدها فقط هنگام ساخت نمایش داده میشوند و قابل لغو هستند. حساب باید فعال و ایمیل تأییدشده باشد. کلید را در سرور خود یا مخزن امن سیستمعامل نگه دارید، نه در کد عمومی مرورگر.
توکن دستگاه dvr_ برنامهٔ دوورا هم پذیرفته میشود. کلیدهای dvk_ برای پروژههای شما هستند. کلیدهای مرجع هرگز به برنامه ارسال نمیشوند.
فهرست مدلها و شناسهٔ اختصاصی
curl https://api.devura.me/v1/models -H "Authorization: Bearer $DEVURA_API_KEY"
در درخواست فقط از id عمومی دوورا استفاده کنید. نام مدل مرجع و ارائهدهنده سمت سرور نگاشت میشوند. فهرست API، نرخها و حدود ورودی و خروجی هر مدل را برمیگرداند.
devura-codeA focused companion for everyday coding.
حد توکن خروجی: 4096agent-wsqlfsxix9myyeu8Coding model for Devura Agent
حد توکن خروجی: 4096ایجنت رایگان پیشفرض
curl https://agent.devura.me/v1/chat/completions \
-H "Authorization: Bearer $DEVURA_API_KEY" \
-H "Content-Type: application/json" \
-d '{"model":"devura-agent","messages":[{"role":"user","content":"Help me fix a failing test."}],"max_tokens":512}'
ایجنت از کیف پول کم نمیکند. مدیر سهمیهٔ رایگان، دستور ثابت و مدلهای پشت ایجنت را تعیین میکند. انتخاب بر اساس ظرفیت آزاد یا تصادفی بین مدلهای دارای ظرفیت است. وقتی هیچ مدلی ظرفیت ندارد پاسخ 503 برمیگردد.
ایجنت در برنامه پاسخ متنی یا tool call میدهد؛ اجرای ابزار، فایل و فرمان روی دستگاه بر عهدهٔ کلاینت و تأییدهای خود برنامه است.
پارامترها و سازگاری
| فیلد | کاربرد |
|---|---|
model | شناسهٔ مدل دوورا؛ برای ایجنت devura-agent |
messages | ۱ تا ۱۰۰ پیام متنی با role؛ تاریخچه را در هر درخواست ارسال کنید. |
max_tokens | سقف خروجی؛ حداکثر برابر حد مدل. max_completion_tokens نیز به همین سقف نگاشت میشود. |
temperature / top_p | در صورت پشتیبانی مدل مرجع |
tools / tool_choice | ابزارهای function؛ خروجی tool_calls به کلاینت بازگردانده میشود. |
response_format | text، json_object یا json_schema در مدلهای پشتیبان |
stream: true | خروجی SSE سازگار با chat.completion.chunk، پس از تکمیل پاسخ مرجع؛ فعلاً ارسال زندهٔ توکنبهتوکن نیست. |
این نسخه برای متن و function tools است؛ تصویر، صدا، embeddings، Responses API و batch در این مسیر پشتیبانی نمیشوند. پارامترهای انتخابشده باید در مدل مرجع هم پشتیبانی شوند.
هزینه و سهمیه
یک سقف حفاظتی درخواست در دقیقه نیز برای هر حساب وجود دارد که مدیر آن را تنظیم میکند و فهرست مدلها و بررسی وضعیت را هم شامل میشود.
یک اعتبار برابر ۱٬۰۰۰٬۰۰۰ میکروکردیت است. نرخها به ازای یک میلیون توکن ثبت میشوند. هزینهٔ API از ورودی غیرکش، ورودی کش و خروجی محاسبه میشود؛ اعتبار حداکثری قبل از درخواست رزرو و باقیمانده پس از پاسخ آزاد میشود. ایجنت رایگان است.
GET https://api.devura.me/v1/usage
GET https://agent.devura.me/v1/usage
سهمیهها برای هر کاربر مستقل هستند و بازهٔ شناور دارند. قوانین عمومی و اختصاصی با هم اعمال میشوند. توکن ورودی و حداکثر خروجی تا پایان درخواست از ظرفیت سهمیه رزرو میشود؛ در پایان مصرف واقعی جایگزین میشود. تلاشهای ناموفق در شمار درخواستها حساب میشوند.
از هزینهٔ تکراری جلوگیری کنید
برای هر کار منطقی یک UUID تازه در هدر Idempotency-Key بفرستید. در تکرار همان کار، همان هدر و بدنه را نگه دارید. پاسخ موفق دوباره برمیگردد؛ تغییر بدنه یا تکرار درخواست در حال اجرا، 409 میدهد. اگر هدر را حذف کنید برای هر درخواست شناسهٔ جدید ساخته میشود.
GET https://api.devura.me/v1/requests/{request_uuid}
شناسهٔ درخواست در id پاسخ موفق پس از chatcmpl- یا متن خطای مرجع دیده میشود؛ فقط مالک میتواند وضعیت را ببیند. هنگام قطع ارتباط یا نبود گزارش معتبر مصرف، وضعیت uncertain میشود و رزرو حفظ میشود تا مدیر با گزارش ارائهدهنده تطبیق دهد. با کلید تازه خودکار دوباره نفرستید.
خطاها
401 | کلید نامعتبر، لغوشده یا حساب تأییدنشده |
402 | اعتبار کیف پول کافی نیست |
409 | تعارض تکرار درخواست یا نیاز به تطبیق |
413 | بدنه یا ورودی مدل بیش از حد بزرگ است |
422 | پارامتر نامعتبر |
429 | سقف سهمیه یا نرخ درخواست |
502 | خطا یا پاسخ نامعتبر ارائهدهنده |
503 | سرویس غیرفعال یا ظرفیت مدلها پر است |
اتصال برنامه و ابزارهای توسعه
در برنامهای که endpoint سازگار با OpenAI دارد، Base URL را روی API یا Agent بگذارید، کلید دوورا را وارد کنید و شناسهٔ عمومی را انتخاب کنید. ایجنت را با devura-agent فراخوانی کنید. این مسیر هیچ کلید مرجعی در کلاینت ذخیره نمیکند.
تا آماده شدن DNS زیردامنهها، مسیرهای همارز روی دامنهٔ اصلی در دسترساند: /api/v1/chat/completions و /api/v1/agent/chat/completions؛ فهرست مدل پولی: /api/v1/catalog.