النماذج والتسعير
عرض النماذج
تصفّح النماذج الأصلية في الـ Gateway عبر Phaseo Gateway، بما في ذلك تفاصيل اختيارية عن التوفر للنماذج غير القابلة للتوجيه.
GET
/
models
عرض نماذج البوابة
const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.phaseo.app/v1/models', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.phaseo.app/v1/models"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)curl --request GET \
--url https://api.phaseo.app/v1/models \
--header 'Authorization: Bearer <token>'package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.phaseo.app/v1/models"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.phaseo.app/v1/models")
.header("Authorization", "Bearer <token>")
.asString();<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.phaseo.app/v1/models",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}require 'uri'
require 'net/http'
url = URI("https://api.phaseo.app/v1/models")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'
response = http.request(request)
puts response.read_body{
"ok": true,
"availability_mode": "active",
"limit": 50,
"offset": 0,
"total": 128,
"models": [
{
"id": "<string>",
"base_model_id": "<string>",
"variant": "<string>",
"variants": {},
"name": "<string>",
"description": "<string>",
"organization": {
"id": "<string>",
"name": "<string>",
"color": "<string>"
},
"aliases": [
"<string>"
],
"lifecycle": {
"status": "active",
"released_at": "<string>",
"deprecated_at": "<string>",
"retires_at": "<string>",
"replacement_id": "<string>",
"message": "<string>"
},
"modalities": {
"input": [
"<string>"
],
"output": [
"<string>"
]
},
"limits": {
"input_tokens": 1,
"output_tokens": 1
},
"capabilities": {
"parameters": [
"<string>"
],
"parameter_details": {},
"endpoints": [
"<string>"
],
"parameter_specs": {}
},
"availability": {
"status": "active",
"provider_count": 1,
"active_provider_count": 1,
"coming_soon_provider_count": 1,
"inactive_provider_count": 1
},
"pricing": {
"pricing_plan": "standard",
"meters": {}
},
"offers": [
{
"provider": {
"id": "<string>",
"name": "<string>"
},
"model": "<string>",
"status": "active",
"status_reason": "active",
"routable": true,
"endpoints": [
"<string>"
],
"modalities": {
"input": [
"<string>"
],
"output": [
"<string>"
]
},
"capabilities": {
"parameters": [
"<string>"
],
"parameter_details": {},
"endpoints": [
"<string>"
],
"parameter_specs": {}
},
"routing": {
"provider": "active",
"model": "active",
"capability": "active"
},
"effective": {
"from": "<string>",
"to": "<string>"
},
"pricing": {
"pricing_plan": "standard",
"meters": {}
},
"service_tiers": [
"flex"
]
}
]
}
],
"access": {
"restricted": true,
"hidden_model_count": 12,
"hidden_models": [
{
"id": "deepseek/deepseek-v4",
"name": "DeepSeek V4"
}
],
"limited_model_count": 3
}
}{
"ok": false,
"error": "invalid_request",
"message": "Invalid request parameters.",
"max_offset": 1
}{
"error": {
"code": "validation_error",
"message": "Unknown parameter: foo",
"type": "invalid_request_error",
"param": "foo"
},
"ok": false,
"code": "validation_error",
"message": "Human-readable error message",
"description": "Additional error details.",
"generation_id": "G-abc123",
"status_code": 502,
"error_type": "system",
"error_origin": "upstream",
"reason": "all_candidates_failed",
"attempt_count": 2,
"failed_providers": [
"google-ai-studio",
"openai"
],
"failed_statuses": [
403,
429
],
"upstream_error": {
"code": "PERMISSION_DENIED",
"message": "The caller does not have permission.",
"description": "<string>",
"param": "<string>"
},
"failure_sample": [
{
"provider": "<string>",
"type": "<string>",
"status": 123,
"upstream_error_code": "<string>",
"upstream_error_message": "<string>",
"upstream_error_description": "<string>",
"upstream_error_param": "<string>",
"upstream_payload_preview": "<string>",
"retryable": true
}
],
"provider_failure_diagnostics": {
"category": "credentials_not_configured",
"hint": "<string>",
"provider": "<string>"
},
"routing_diagnostics": {
"filterStages": [
{
"stage": "<string>",
"beforeCount": 123,
"afterCount": 123,
"droppedProviders": [
{
"providerId": "<string>",
"reason": "<string>"
}
]
}
]
},
"provider_candidate_diagnostics": {
"totalProviders": 123,
"supportsEndpointCount": 123,
"candidateCount": 123,
"droppedUnsupportedEndpoint": [
"<string>"
],
"droppedMissingAdapter": [
{
"providerId": "<string>",
"endpoint": "<string>"
}
]
},
"provider_enablement": {
"capability": "<string>",
"providersBefore": [
"<string>"
],
"providersAfter": [
"<string>"
],
"dropped": [
{
"providerId": "<string>",
"reason": "<string>"
}
]
},
"missing_pricing_providers": [
"<string>"
],
"provider_payment_required_provider": "openai",
"provider_payment_required_support_notice": "Our upstream provider billing appears to be unavailable. If this persists, contact support.",
"details": [
{}
]
}{
"error": {
"code": "validation_error",
"message": "Unknown parameter: foo",
"type": "invalid_request_error",
"param": "foo"
},
"ok": false,
"code": "validation_error",
"message": "Human-readable error message",
"description": "Additional error details.",
"generation_id": "G-abc123",
"status_code": 502,
"error_type": "system",
"error_origin": "upstream",
"reason": "all_candidates_failed",
"attempt_count": 2,
"failed_providers": [
"google-ai-studio",
"openai"
],
"failed_statuses": [
403,
429
],
"upstream_error": {
"code": "PERMISSION_DENIED",
"message": "The caller does not have permission.",
"description": "<string>",
"param": "<string>"
},
"failure_sample": [
{
"provider": "<string>",
"type": "<string>",
"status": 123,
"upstream_error_code": "<string>",
"upstream_error_message": "<string>",
"upstream_error_description": "<string>",
"upstream_error_param": "<string>",
"upstream_payload_preview": "<string>",
"retryable": true
}
],
"provider_failure_diagnostics": {
"category": "credentials_not_configured",
"hint": "<string>",
"provider": "<string>"
},
"routing_diagnostics": {
"filterStages": [
{
"stage": "<string>",
"beforeCount": 123,
"afterCount": 123,
"droppedProviders": [
{
"providerId": "<string>",
"reason": "<string>"
}
]
}
]
},
"provider_candidate_diagnostics": {
"totalProviders": 123,
"supportsEndpointCount": 123,
"candidateCount": 123,
"droppedUnsupportedEndpoint": [
"<string>"
],
"droppedMissingAdapter": [
{
"providerId": "<string>",
"endpoint": "<string>"
}
]
},
"provider_enablement": {
"capability": "<string>",
"providersBefore": [
"<string>"
],
"providersAfter": [
"<string>"
],
"dropped": [
{
"providerId": "<string>",
"reason": "<string>"
}
]
},
"missing_pricing_providers": [
"<string>"
],
"provider_payment_required_provider": "openai",
"provider_payment_required_support_notice": "Our upstream provider billing appears to be unavailable. If this persists, contact support.",
"details": [
{}
]
}استدعِ
يسرد كل نموذج إدخالًا واحدًا في
لا توجّه حركة الإنتاج إلا إلى عرض تكون فيه قيمة
لفحص مسارات المزوّدين لنموذج واحد وتفاصيل معاملاته وتسعيره، استدعِ
يستخدم تنسيق OpenAI المصادقة نفسها والتوفر الإقليمي نفسه والنماذج الخاصة بمساحة العمل والمرشحات نفسها كما في JSON الأصلي. يُرجع كل النماذج المطابقة ما لم تقدّم
توفّر الاستجابة
GET /v1/models لعرض النماذج التي يمكنك التوجيه إليها الآن. اضبط availability=all لتضمين النماذج المعروفة لكنها غير متاحة حاليًا.
curl "https://api.phaseo.app/v1/models?limit=50" \
-H "Authorization: Bearer $PHASEO_API_KEY"
offers لكل مسار مزوّد (مختصر، والقيم توضيحية):
{
"ok": true,
"availability_mode": "active",
"limit": 50,
"offset": 0,
"total": 412,
"models": [
{
"id": "anthropic/claude-sonnet-5.5",
"name": "Claude Sonnet 5.5",
"organization": { "id": "anthropic", "name": "Anthropic", "color": "#d97757" },
"lifecycle": { "status": "active", "released_at": "2026-09-28", "replacement_id": null },
"modalities": { "input": ["text", "image"], "output": ["text"] },
"capabilities": { "endpoints": ["chat.completions", "messages", "responses"] },
"availability": { "status": "active", "provider_count": 3, "active_provider_count": 3 },
"offers": [
{
"provider": { "id": "anthropic", "name": "Anthropic" },
"model": "claude-sonnet-5-5",
"status": "active",
"status_reason": null,
"routable": true,
"service_tiers": ["standard"],
"routing": { "provider": "active", "model": "active", "capability": "active" }
}
]
}
]
}
routable هي true. يوضح status_reason سبب كون العرض للمعاينة فقط أو غير نشط. المخطط الكامل أدناه.
يُرجع GET /models/me القائمة نفسها بعد تطبيق ضوابط الحماية الخاصة بمفتاحك: قواعد الخصوصية والمزوّدين في مساحة العمل، وضوابط الحماية على أقسام المفتاح وعضوه والمفتاح نفسه. تُستبعد النماذج التي تحظرها قاعدة نماذج، والنماذج التي لا يتوفر لها أي مزوّد مسموح به، ولا يبقى لكل نموذج إلا العروض التي يمكن توجيه طلباته إليها. ويقبل عوامل التصفية نفسها التي يقبلها GET /models. وتتضمن الاستجابة أيضًا access: ما إذا كانت أي قاعدة مطبّقة (restricted)، والنماذج التي تستبعدها القواعد (hidden_model_count وhidden_models، مع المعرّفات والأسماء)، وعدد النماذج المدرجة التي فقدت بعض مزوّديها (limited_model_count)، لتتمكن من إخبار المستخدمين بسبب غياب نموذج ما.
صفِّ القائمة
تقبل المرشحات التي تأخذ عدة قيم معاملات مكررة أو قائمة مفصولة بفواصل.| المعامل | يصفّي حسب |
|---|---|
availability | active (الافتراضي) للنماذج القابلة للتوجيه علنًا، أو all لإضافة النماذج والمزوّدين coming_soon وinactive وغير القابلين للتوجيه بعد |
endpoints | أسماء نقاط النهاية العامة، مثل chat.completions وresponses وmessages |
status | دورة حياة النموذج، مثل active أو deprecated أو retired |
organisation | بادئة معرّف النموذج، مثل anthropic في anthropic/claude-3-haiku |
provider | معرّف المزوّد العام، مثل openai أو anthropic أو google_vertex |
provider_status | مستوى إطلاق المزوّد، مثل active أو beta أو alpha أو not_ready |
provider_routing_status | حالة التوجيه على مستوى المزوّد |
model_routing_status | حالة التوجيه على مستوى النموذج |
capability_status | حالة قدرة المزوّد لربط نقطة النهاية المطلوبة |
provider_availability_status | التوفر لدى المزوّد، مثل active أو coming_soon أو inactive |
provider_availability_reason | سبب عدم توفر مزوّد، مثل preview_only أو provider_not_ready أو gated أو access_limited أو region_limited |
input_types (الاسم المستعار input_modalities) | وسائط الإدخال |
output_types (الاسم المستعار output_modalities) | وسائط الإخراج |
params (الاسم المستعار supported_parameters) | معاملات الطلب المدعومة |
GET /models/{author}/{slug}/endpoints.
تحقق من فئات الخدمة لكل عرض
يتضمن كل إدخال فيoffers الحقل service_tiers، وهو فئات الخدمة التي يقبلها عرض ذلك المزوّد. وهو مجموعة فرعية مرتّبة أبجديًا من flex وpriority وstandard وultrafast، حيث priority هي الفئة Fast. تُدرج الفئة عندما يكون لمسار المزوّد تسعير نشط وساري المفعول حاليًا لها، والمسار الذي يخدم فئة واحدة يُدرج تلك الفئة فقط. تتوفر بعض الفئات أيضًا عبر مسارات مزوّدين منفصلة خاصة بالفئة وغير مدرجة. تظل الأسعار تحت pricing أسعار الفئة القياسية.
احصل على القائمة بتنسيق OpenAI
استخدمGET /v1/models?format=openai للعملاء التي تتوقع استجابة قائمة النماذج الخاصة بـ OpenAI. تُرجع القيمة الافتراضية format=json البيانات الوصفية الأغنى للنماذج في Phaseo.
curl "https://api.phaseo.app/v1/models?format=openai" \
-H "Authorization: Bearer $PHASEO_API_KEY"
{
"object": "list",
"data": [
{ "id": "openai/gpt-6-astra", "object": "model", "created": 1788393600, "owned_by": "openai" }
]
}
limit؛ ويظل offset ساريًا. تبقى المعرّفات بصيغة Phaseo القياسية للاستدلال. يستخدم created تاريخ الإصدار في الفهرس، أو 0 عندما يكون غير معروف؛ ويستخدم owned_by المؤسسة في الفهرس، أو private لنماذج مساحة العمل، أو phaseo عندما تكون غير معروفة.
خزّن قائمة النماذج مؤقتًا
تُخزَّن استجابات الفهرس مؤقتًا لمدة خمس دقائق، وقد تُقدَّم لخمس دقائق أخرى أثناء إعادة التحقق من الذاكرة المؤقتة. ينطبق هذا على تمثيلات JSON وRSS وAtom للفهرس الحالي؛ أما موجز الإصدارات فله ذاكرة استطلاع مؤقتة خاصة أقصر. تتضمن استجابات JSON وتنسيق OpenAI ترويسةETag ضعيفة (W/"…"). تتغير عندما تتغير النماذج في الصفحة أو limit أو offset أو total أو التنسيق. وتتجاهل gateway_region، لذا يحمل الفهرس نفسه المقدَّم من منطقة أخرى قيمة ETag نفسها. لهذا هي ضعيفة: الاستجابات التي تتشاركها متكافئة، لكن بايتاتها قد تختلف. لا تتضمنها استجابات RSS وAtom والأخطاء.
أعد إرسال القيمة المحفوظة دون تغيير في If-None-Match. إذا لم يتغير الفهرس، تكون الاستجابة 304 Not Modified بلا جسم، وتكرر ترويسات ETag وCache-Control وVary. وإلا فستحصل على 200 عادية مع القائمة الجديدة وETag جديدة. يقبل If-None-Match أيضًا قائمة مفصولة بفواصل و*، والمقارنة ضعيفة، لذا تتطابق القيمة مع البادئة W/ أو بدونها.
let etag: string | null = null;
let models: unknown[] = [];
async function refreshModels() {
const response = await fetch("https://api.phaseo.app/v1/models?limit=250", {
headers: {
Authorization: `Bearer ${process.env.PHASEO_API_KEY}`,
...(etag ? { "If-None-Match": etag } : {}),
},
});
if (response.status === 304) return models; // Unchanged; a 304 has no body.
if (!response.ok) throw new Error(`Model list request failed: ${response.status}`);
etag = response.headers.get("ETag");
models = (await response.json()).models;
return models;
}
304 النقل والتحليل. ومع ذلك يقيّم الخادم الطلب: فهو يحمّل الفهرس ويعيد حساب ETag. الاستطلاع كل 15 دقيقة تقريبًا كافٍ، مع تنزيل القائمة مجددًا فقط عندما يتغير الفهرس. احتفظ بقيمة ETag واحدة لكل عنوان URL للطلب، لأن لكل صفحة ومجموعة مرشحات وتنسيق قيمته الخاصة.الترويسات
معلمات الاستعلام
التصفية حسب المؤسسة معرّف المؤسسة.
الخيارات المتاحة:
01-ai, adept, ai21, aion-labs, aisingapore, alibaba, allenai, amazon, anthracite-org, anthropic, arcee-ai, baai, baichuan, baidu, bigcode, black-forest-labs, bytedance, bytedance-seed, cogito, cognitivecomputations, cohere, crofai, cursor, cyfragovpl, databricks, dealignai, decart, deepseek, dots-studio, early-access, eleven-labs, essential-ai, fastino, fish-audio, github, google, gryphe, hexgrad, ibm, ibm-granite, inception, inclusionai, inference-net, inflection, intfloat, jetbrains, kblab, kling, kuaishou, kwaipilot, kwaivgi, lg, lightricks, liquid-ai, mancer, medaibase, meituan, meta, microsoft, mindai, minimax, mistral, mistralai, moonshotai, morph, naver-hyperclova, near-ai, nex-agi, nous, nousresearch, novasearch, nvidia, openai, openbmb, opencompass, opengvlab, orcarouter, ornith, perceptron, perplexity, phala, pixverse, poe, poolside, prime-intellect, prism-ml, qwen, reka, relace, runway, sakana, sao10k, sapiens-ai, sentence-transformers, sference, shanghai-ai-laboratory, shengshu-ai, snowflake, sourceful, spacex-ai, speakleash, stability-ai, stealth, stepfun, suno, tencent, thedrummer, thinking-machines, undi95, upstage, venice, vercel, villanova-ai, voyage, windsurf, writer, xai, xgenerationlab, xiaomi, z-ai, zyphra الاستجابة
قائمة النماذج
- Option 1
- Option 2
آخر تعديل في ١٦ نوفمبر ٢٠٢٦
هل كانت هذه الصفحة مفيدة؟
⌘I
عرض نماذج البوابة
const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.phaseo.app/v1/models', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.phaseo.app/v1/models"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)curl --request GET \
--url https://api.phaseo.app/v1/models \
--header 'Authorization: Bearer <token>'package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.phaseo.app/v1/models"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.phaseo.app/v1/models")
.header("Authorization", "Bearer <token>")
.asString();<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.phaseo.app/v1/models",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}require 'uri'
require 'net/http'
url = URI("https://api.phaseo.app/v1/models")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'
response = http.request(request)
puts response.read_body{
"ok": true,
"availability_mode": "active",
"limit": 50,
"offset": 0,
"total": 128,
"models": [
{
"id": "<string>",
"base_model_id": "<string>",
"variant": "<string>",
"variants": {},
"name": "<string>",
"description": "<string>",
"organization": {
"id": "<string>",
"name": "<string>",
"color": "<string>"
},
"aliases": [
"<string>"
],
"lifecycle": {
"status": "active",
"released_at": "<string>",
"deprecated_at": "<string>",
"retires_at": "<string>",
"replacement_id": "<string>",
"message": "<string>"
},
"modalities": {
"input": [
"<string>"
],
"output": [
"<string>"
]
},
"limits": {
"input_tokens": 1,
"output_tokens": 1
},
"capabilities": {
"parameters": [
"<string>"
],
"parameter_details": {},
"endpoints": [
"<string>"
],
"parameter_specs": {}
},
"availability": {
"status": "active",
"provider_count": 1,
"active_provider_count": 1,
"coming_soon_provider_count": 1,
"inactive_provider_count": 1
},
"pricing": {
"pricing_plan": "standard",
"meters": {}
},
"offers": [
{
"provider": {
"id": "<string>",
"name": "<string>"
},
"model": "<string>",
"status": "active",
"status_reason": "active",
"routable": true,
"endpoints": [
"<string>"
],
"modalities": {
"input": [
"<string>"
],
"output": [
"<string>"
]
},
"capabilities": {
"parameters": [
"<string>"
],
"parameter_details": {},
"endpoints": [
"<string>"
],
"parameter_specs": {}
},
"routing": {
"provider": "active",
"model": "active",
"capability": "active"
},
"effective": {
"from": "<string>",
"to": "<string>"
},
"pricing": {
"pricing_plan": "standard",
"meters": {}
},
"service_tiers": [
"flex"
]
}
]
}
],
"access": {
"restricted": true,
"hidden_model_count": 12,
"hidden_models": [
{
"id": "deepseek/deepseek-v4",
"name": "DeepSeek V4"
}
],
"limited_model_count": 3
}
}{
"ok": false,
"error": "invalid_request",
"message": "Invalid request parameters.",
"max_offset": 1
}{
"error": {
"code": "validation_error",
"message": "Unknown parameter: foo",
"type": "invalid_request_error",
"param": "foo"
},
"ok": false,
"code": "validation_error",
"message": "Human-readable error message",
"description": "Additional error details.",
"generation_id": "G-abc123",
"status_code": 502,
"error_type": "system",
"error_origin": "upstream",
"reason": "all_candidates_failed",
"attempt_count": 2,
"failed_providers": [
"google-ai-studio",
"openai"
],
"failed_statuses": [
403,
429
],
"upstream_error": {
"code": "PERMISSION_DENIED",
"message": "The caller does not have permission.",
"description": "<string>",
"param": "<string>"
},
"failure_sample": [
{
"provider": "<string>",
"type": "<string>",
"status": 123,
"upstream_error_code": "<string>",
"upstream_error_message": "<string>",
"upstream_error_description": "<string>",
"upstream_error_param": "<string>",
"upstream_payload_preview": "<string>",
"retryable": true
}
],
"provider_failure_diagnostics": {
"category": "credentials_not_configured",
"hint": "<string>",
"provider": "<string>"
},
"routing_diagnostics": {
"filterStages": [
{
"stage": "<string>",
"beforeCount": 123,
"afterCount": 123,
"droppedProviders": [
{
"providerId": "<string>",
"reason": "<string>"
}
]
}
]
},
"provider_candidate_diagnostics": {
"totalProviders": 123,
"supportsEndpointCount": 123,
"candidateCount": 123,
"droppedUnsupportedEndpoint": [
"<string>"
],
"droppedMissingAdapter": [
{
"providerId": "<string>",
"endpoint": "<string>"
}
]
},
"provider_enablement": {
"capability": "<string>",
"providersBefore": [
"<string>"
],
"providersAfter": [
"<string>"
],
"dropped": [
{
"providerId": "<string>",
"reason": "<string>"
}
]
},
"missing_pricing_providers": [
"<string>"
],
"provider_payment_required_provider": "openai",
"provider_payment_required_support_notice": "Our upstream provider billing appears to be unavailable. If this persists, contact support.",
"details": [
{}
]
}{
"error": {
"code": "validation_error",
"message": "Unknown parameter: foo",
"type": "invalid_request_error",
"param": "foo"
},
"ok": false,
"code": "validation_error",
"message": "Human-readable error message",
"description": "Additional error details.",
"generation_id": "G-abc123",
"status_code": 502,
"error_type": "system",
"error_origin": "upstream",
"reason": "all_candidates_failed",
"attempt_count": 2,
"failed_providers": [
"google-ai-studio",
"openai"
],
"failed_statuses": [
403,
429
],
"upstream_error": {
"code": "PERMISSION_DENIED",
"message": "The caller does not have permission.",
"description": "<string>",
"param": "<string>"
},
"failure_sample": [
{
"provider": "<string>",
"type": "<string>",
"status": 123,
"upstream_error_code": "<string>",
"upstream_error_message": "<string>",
"upstream_error_description": "<string>",
"upstream_error_param": "<string>",
"upstream_payload_preview": "<string>",
"retryable": true
}
],
"provider_failure_diagnostics": {
"category": "credentials_not_configured",
"hint": "<string>",
"provider": "<string>"
},
"routing_diagnostics": {
"filterStages": [
{
"stage": "<string>",
"beforeCount": 123,
"afterCount": 123,
"droppedProviders": [
{
"providerId": "<string>",
"reason": "<string>"
}
]
}
]
},
"provider_candidate_diagnostics": {
"totalProviders": 123,
"supportsEndpointCount": 123,
"candidateCount": 123,
"droppedUnsupportedEndpoint": [
"<string>"
],
"droppedMissingAdapter": [
{
"providerId": "<string>",
"endpoint": "<string>"
}
]
},
"provider_enablement": {
"capability": "<string>",
"providersBefore": [
"<string>"
],
"providersAfter": [
"<string>"
],
"dropped": [
{
"providerId": "<string>",
"reason": "<string>"
}
]
},
"missing_pricing_providers": [
"<string>"
],
"provider_payment_required_provider": "openai",
"provider_payment_required_support_notice": "Our upstream provider billing appears to be unavailable. If this persists, contact support.",
"details": [
{}
]
}