راهنمای توسعه‌دهندگان v1.0DEVELOPERS AURA / API REFERENCE

مدل‌های دوورا، در برنامهٔ شما.

یک API سازگار با Chat Completions، شناسه‌های مدل دوورا و یک ایجنت رایگان با سهمیهٔ مشخص.

API پولیhttps://api.devura.me/v1
ایجنت رایگانhttps://agent.devura.me/v1

اولین پاسخ در چند خط

در پنل یک کلید بسازید، از فهرست مدل‌ها یک Model ID فعال بردارید و آن را جای devura-model-id بگذارید. برای API پولی، کیف پول باید اعتبار کافی داشته باشد.

DEVURA / EXAMPLEScURL
request.sh

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}'
آمادهٔ استفاده5 خط UTF-8 cURL

Python · OpenAI SDK

DEVURA / EXAMPLESPython
main.py

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)
آمادهٔ استفاده14 خط UTF-8 Python

کلید دوورا؛ نه کلید ارائه‌دهنده

هدر Authorization: Bearer الزامی است. کلیدها فقط هنگام ساخت نمایش داده می‌شوند و قابل لغو هستند. حساب باید فعال و ایمیل تأییدشده باشد. کلید را در سرور خود یا مخزن امن سیستم‌عامل نگه دارید، نه در کد عمومی مرورگر.

توکن دستگاه dvr_ برنامهٔ دوورا هم پذیرفته می‌شود. کلیدهای dvk_ برای پروژه‌های شما هستند. کلیدهای مرجع هرگز به برنامه ارسال نمی‌شوند.

فهرست مدل‌ها و شناسهٔ اختصاصی

DEVURA / EXAMPLEScURL
models.sh

curl https://api.devura.me/v1/models -H "Authorization: Bearer $DEVURA_API_KEY"
آمادهٔ استفاده1 خط UTF-8 cURL

در درخواست فقط از id عمومی دوورا استفاده کنید. نام مدل مرجع و ارائه‌دهنده سمت سرور نگاشت می‌شوند. فهرست API، نرخ‌ها و حدود ورودی و خروجی هر مدل را برمی‌گرداند.

Devura Code devura-code

A focused companion for everyday coding.

حد توکن خروجی: 4096
Qwen 2.5 Coder 32B agent-wsqlfsxix9myyeu8

Coding model for Devura Agent

حد توکن خروجی: 4096

ایجنت رایگان پیش‌فرض

DEVURA / EXAMPLEScURL
agent.sh

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}'
آمادهٔ استفاده4 خط UTF-8 cURL

ایجنت از کیف پول کم نمی‌کند. مدیر سهمیهٔ رایگان، دستور ثابت و مدل‌های پشت ایجنت را تعیین می‌کند. انتخاب بر اساس ظرفیت آزاد یا تصادفی بین مدل‌های دارای ظرفیت است. وقتی هیچ مدلی ظرفیت ندارد پاسخ 503 برمی‌گردد.

ایجنت در برنامه پاسخ متنی یا tool call می‌دهد؛ اجرای ابزار، فایل و فرمان روی دستگاه بر عهدهٔ کلاینت و تأییدهای خود برنامه است.

پارامترها و سازگاری

فیلدکاربرد
modelشناسهٔ مدل دوورا؛ برای ایجنت devura-agent
messages۱ تا ۱۰۰ پیام متنی با role؛ تاریخچه را در هر درخواست ارسال کنید.
max_tokensسقف خروجی؛ حداکثر برابر حد مدل. max_completion_tokens نیز به همین سقف نگاشت می‌شود.
temperature / top_pدر صورت پشتیبانی مدل مرجع
tools / tool_choiceابزارهای function؛ خروجی tool_calls به کلاینت بازگردانده می‌شود.
response_formattext، json_object یا json_schema در مدل‌های پشتیبان
stream: trueخروجی SSE سازگار با chat.completion.chunk، پس از تکمیل پاسخ مرجع؛ فعلاً ارسال زندهٔ توکن‌به‌توکن نیست.

این نسخه برای متن و function tools است؛ تصویر، صدا، embeddings، Responses API و batch در این مسیر پشتیبانی نمی‌شوند. پارامترهای انتخاب‌شده باید در مدل مرجع هم پشتیبانی شوند.

هزینه و سهمیه

یک سقف حفاظتی درخواست در دقیقه نیز برای هر حساب وجود دارد که مدیر آن را تنظیم می‌کند و فهرست مدل‌ها و بررسی وضعیت را هم شامل می‌شود.

یک اعتبار برابر ۱٬۰۰۰٬۰۰۰ میکروکردیت است. نرخ‌ها به ازای یک میلیون توکن ثبت می‌شوند. هزینهٔ API از ورودی غیرکش، ورودی کش و خروجی محاسبه می‌شود؛ اعتبار حداکثری قبل از درخواست رزرو و باقی‌مانده پس از پاسخ آزاد می‌شود. ایجنت رایگان است.

DEVURA / EXAMPLESHTTP
usage.http

GET https://api.devura.me/v1/usage
GET https://agent.devura.me/v1/usage
آمادهٔ استفاده2 خط UTF-8 HTTP

سهمیه‌ها برای هر کاربر مستقل هستند و بازهٔ شناور دارند. قوانین عمومی و اختصاصی با هم اعمال می‌شوند. توکن ورودی و حداکثر خروجی تا پایان درخواست از ظرفیت سهمیه رزرو می‌شود؛ در پایان مصرف واقعی جایگزین می‌شود. تلاش‌های ناموفق در شمار درخواست‌ها حساب می‌شوند.

از هزینهٔ تکراری جلوگیری کنید

برای هر کار منطقی یک UUID تازه در هدر Idempotency-Key بفرستید. در تکرار همان کار، همان هدر و بدنه را نگه دارید. پاسخ موفق دوباره برمی‌گردد؛ تغییر بدنه یا تکرار درخواست در حال اجرا، 409 می‌دهد. اگر هدر را حذف کنید برای هر درخواست شناسهٔ جدید ساخته می‌شود.

DEVURA / EXAMPLESHTTP
request-status.http

GET https://api.devura.me/v1/requests/{request_uuid}
آمادهٔ استفاده1 خط UTF-8 HTTP

شناسهٔ درخواست در 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.

دریافت مشخصات OpenAPI ↗