مرجع نقطه‌های پایانی
فهرست نقطه‌های پایانی /v1 با پارامترها و پاسخ‌ها، از روی مشخصات OpenAPI.
این صفحه از روی مشخصات OpenAPI ساخته می‌شود. متن توضیح‌ها در مشخصات به انگلیسی است.
احراز هویت
Authorization: Bearer <کلید hvd_...>
POST /v1/chat/completions
OpenAI-compatible chat completion (JSON or SSE). hvd_... developer key or a dashboard JWT. With stream: true the response is text/event-stream (data: {chat.completion.chunk} lines, terminated by data: [DONE]). Unknown fields are ignored. Body limit OPENAI_API_MAX_REQUEST_MB (40). Errors always use the OpenAI envelope, **including 401**.
بدنهٔ درخواست (JSON)
| نام | نوع | الزامی | توضیح |
|---|---|---|---|
| model | string | بله | Catalog slug or auto. |
| messages | object[] | بله | |
| max_tokens | integer | خیر | |
| max_completion_tokens | integer | خیر | |
| temperature | number | خیر | |
| stream | boolean | خیر | |
| stream_options | object | خیر |
فیلدهای پاسخ موفق
| نام | نوع | الزامی | توضیح |
|---|---|---|---|
| id | string | بله | |
| object | "chat.completion" | بله | |
| created | integer | بله | |
| model | string | بله | |
| choices | object[] | بله | |
| usage | object | بله |
پاسخ‌ها
| وضعیت | توضیح |
|---|---|
| 200 | Completion (JSON) or event stream. |
| 400 | invalid_json, missing_required_parameter, invalid_type, invalid_value, unsupported_value, invalid_image_url, too_many_images. |
| 401 | invalid_api_key / token_expired / session_revoked. |
| 402 | insufficient_credits / quota_exceeded (+ wallet_balance_units, quota_code). |
| 403 | model_requires_paid_plan / content_blocked. |
| 404 | model_not_found. |
| 413 | request_too_large. |
| 415 | |
| 422 | context_length_exceeded / model_does_not_support_images. Also {"msg": ...} for a malformed/wrong-type token. |
| 429 | rate_limit_exceeded or too_many_concurrent; carries Retry-After. |
| 500 | internal_error. |
| 502 | provider_error (provider failure or empty answer). |
| 503 | model_unavailable / service_unavailable (+ Retry-After). |
| 504 | provider_timeout. |
GET /v1/models
List models usable by the caller's plan
فیلدهای پاسخ موفق
| نام | نوع | الزامی | توضیح |
|---|---|---|---|
| object | "list" | بله | |
| data | object[] | بله |
پاسخ‌ها
| وضعیت | توضیح |
|---|---|
| 200 | OK |
| 401 | invalid_api_key / token_expired / session_revoked. |
| 422 | |
| 429 | rate_limit_exceeded or too_many_concurrent; carries Retry-After. |
| 500 | internal_error. |
| 503 | service_unavailable: catalog not seeded. |
GET /v1/models/{model_id}
Retrieve one model
پارامترهای مسیر
| نام | نوع | الزامی | توضیح |
|---|---|---|---|
| model_id | string | بله | path |
فیلدهای پاسخ موفق
| نام | نوع | الزامی | توضیح |
|---|---|---|---|
| id | string | بله | |
| object | "model" | بله | |
| created | integer | بله | |
| owned_by | "hoveydai" | بله | |
| context_window | integer | خیر | |
| max_output_tokens | integer | خیر | |
| supports_vision | boolean | خیر |
پاسخ‌ها
| وضعیت | توضیح |
|---|---|
| 200 | OK |
| 401 | invalid_api_key / token_expired / session_revoked. |
| 404 | model_not_found. |
| 422 | |
| 429 | rate_limit_exceeded or too_many_concurrent; carries Retry-After. |
| 500 | internal_error. |
| 503 | service_unavailable. |
قالب خطا
همهٔ پاسخ‌های خطای /v1 این قالب را دارند:
| نام | نوع | الزامی | توضیح |
|---|---|---|---|
| message | string | بله | |
| type | "invalid_request_error" | "insufficient_credits" | "permission_error" | "rate_limit_error" | "server_error" | بله | |
| param | string | null | بله | |
| code | string | بله | Stable code, e.g. invalid_api_key, token_expired, session_revoked, invalid_json, missing_required_parameter, invalid_type, invalid_value, unsupported_value, model_not_found, model_requires_paid_plan, insufficient_credits, quota_exceeded, context_length_exceeded, request_too_large, rate_limit_exceeded, too_many_concurrent, model_unavailable, service_unavailable, provider_timeout, provider_error, content_blocked, internal_error, unknown_url, method_not_allowed. |
| request_id | string | خیر | Also sent as the x-request-id header. |
| quota_code | string | خیر | |
| wallet_balance_units | integer | خیر | |
| suggested_models | string[] | خیر |
منبع: docs/openapi.yaml
این صفحه کمکتان نکرد؟ به ما بگویید.