OpenAI uyumlu API dokümantasyonu
ChatGPT, Codex ve GLM tek bir API üzerinden.
Model.sale; ChatGPT uyumlu GPT, Codex istemcileri, GLM ve DeepSeek modelleri için tanıdık bir OpenAI uyumlu base URL sunar. Anahtarınızı sunucu tarafında tutun, canlı bir model kimliği kullanın ve her çağrıyla dönen istek kimliğini ve kullanım bilgisini inceleyin.
/v1/responses bulunan bir model seçin.Authorization: Bearer ms_live_… gönderin. Anahtarlar bir kez gösterilir ve panelden iptal edilebilir.GET /v1/models içinden bir model kullanın. Bir istek asla sessizce başka bir modele yönlendirilmez.Endpoint'ler
| Yöntem | Yol | Amaç |
|---|---|---|
| GET | /v1/models | Yayımlanmış canlı katalog |
| GET | /v1/models/{id} | Çağrılabilir tek bir model (OpenAI models.retrieve) |
| GET | /v1/catalog | Canlı/kullanılamıyor durumuyla fiyatlandırılmış tam kayıt |
| POST | /v1/responses | Responses JSON ve SSE (GPT/Codex) |
| POST | /v1/chat/completions | Chat Completions JSON ve SSE (GPT/GLM/DeepSeek) |
| POST | /v1/messages | Yalnızca Anthropic Messages doğrulaması yayımlandığında |
Bazı katalog modelleri neden /v1/models içinde yok?
/v1/models bilerek yalnızca şu anda müşteri trafiğine kabul edilmiş modelleri içerir. /v1/catalog fiyatı olan her kimliği, yoklama sonucu ve desteklenen endpoint'leriyle görünür tutar; canlı kontrolü geçmiş ancak denetlenen fiyat/marj yayımını bekleyen modeller de dahildir. Bir model yalnızca yeni bir JSON/SSE kontrolü, nihai kullanım bilgisi ve yayın onayından sonra kabul edilir; asla sessizce başka bir modelle değiştirilmez.Protokol yetenekleri
Her modelin güncel supported_endpoints değerini görmek için /v1/catalog kullanın. Codex, /v1/responses destekleyen canlı bir model gerektirir; GLM ve DeepSeek şu anda /v1/chat/completions kullanır. Claude kimlikleri fiyatlandırıldığında görünür kalır, ancak Messages erişimi yalnızca doğrulaması geçtikten sonra etkinleştirilir.
Minimal Responses isteği
Güncel yayımlanmış Responses örneği: gpt-5.5. Hâlâ şurada göründüğünü doğrulayın: GET /v1/models.
curl https://api.model.sale/v1/responses \
-H "Authorization: Bearer $MODEL_SALE_API_KEY" \
-H "Content-Type: application/json" \
-d '{"model":"gpt-5.5","input":"Reply exactly OK"}'Akış (streaming)
stream: true ayarlayın. Responses akışları bir nihai response olayıyla, Chat Completions akışları [DONE] ile biter. Ağ geçidi her yanıta x-model-sale-request-id ekler. Kesin mutabakat için kullanım bilgisi gereklidir; eksik kullanım bilgisi mutabakat için işaretlenir.
Kimlik doğrulama
Anahtarı Authorization: Bearer ms_live_… (OpenAI SDK'ları, Codex) veya x-api-key: ms_live_… (Anthropic SDK'ları) olarak gönderin. Tarayıcı uygulamaları API'yi doğrudan çağırabilir: /v1/* için CORS çerezsiz etkindir; anahtarı yalnızca denetlediğiniz bir tarayıcıya gönderin.
Hatalar ve limitler
Hatalar OpenAI biçimini kullanır: {"error":{"message","type","param","code"}} (/v1/messages üzerinde Anthropic biçimi). type kategoridir, code ise belirli nedendir.
| Durum | type | Tipik code | Ne yapmalı |
|---|---|---|---|
| 400 | invalid_request_error | invalid_json, model_required | İstek gövdesini düzeltin; mesaj sorunu belirtir. |
| 401 | authentication_error | invalid_api_key | Anahtarı kontrol edin veya panelden yeni bir tane oluşturun. |
| 402 | insufficient_quota | insufficient_balance | Faturalama bölümünden bakiye yükleyin, sonra yeniden deneyin. |
| 403 | permission_error | model_not_allowed, ip_not_allowed | Anahtarın model veya IP kısıtlamalarını ayarlayın. |
| 404 | not_found_error | model_not_found | GET /v1/models içinden bir kimlik kullanın. |
| 413 | invalid_request_error | request_too_large | İstek gövdeleri 8 MB ile sınırlıdır. |
| 429 | rate_limit_error | rate_limit_exceeded, spend_limit_exceeded | Retry-After saniye bekleyin veya anahtarın limitlerini yükseltin. |
| 502/503 | server_error | upstream_error, model_unavailable | Geri çekilmeyle yeniden deneyin; başarısız istekler ücretlendirilmez. |