Kuyruk API'sine nereden başlanır

Kuyruk API'siyle ilk üretime giden sıra: anahtarı çıkarın, modeli kimliğiyle seçin, işi kuyruğa verin, durumunu yoklayın, çıktıyı indirin.

Bu sayfa sözleşmenin kendisi değil, onu okuma sırası. Sözleşmenin tamamı — her uç, her durum değeri, her hata kodu — API dokümantasyonunda; aşağıdaki her adım oraya bağlanıyor.

İlk üretime giden sıra

Her adım dokümantasyonun o işi taşıyan bölümünde bitiyor: burada özet, orada sözleşme.

  1. API anahtarı çıkarın

    Anahtar panelde üretilir ve Authorization başlığında taşınır. /v1 altındaki her şey bu kapının arkasındadır; tek istisna herkese açık katalog ucudur ve o anahtar istemez.

    Kimlik doğrulama

  2. Modeli kimliğiyle seçin

    Model ad alanlı kimliğiyle çağrılır. Kimlik, arkasındaki sürüm değiştirilse bile sabit kalır — yani kodunuzun tutması gereken tek dize odur.

    Katalog

  3. İşi kuyruğa verin

    Üretim saniyeler değil dakikalar sürer, bu yüzden gönderim çıktı değil bir kimlik döner. Kısa işler için tek çağrılık bir yol var, ama uzun süren iş kuyruğa aittir.

    İlk istek

  4. Durumu yoklayın, kodları karşılayın

    Durum ayrı bir uçtan okunur ve her hâlin adı vardır. Hız sınırı bellekte değil veritabanında sayılır: bir istekte dolan sınır bir sonrakinde de doludur.

    Durumlar ve hatalar

  5. Çıktıyı yedi gün içinde alın

    Bayt kendi alan adımızdan iner, hiçbir zaman bir sağlayıcı adresinden değil. Yedi gün sonra çıktı, onu üreten girdiyle birlikte silinir: saklamak istediğinizi indirin.

    Saklama penceresi

Kodunuzun çağırabileceği katalog

Bu sayılar elle yazılmadı: modellerin listelendiği herkese açık uçtan türer ve katalog değiştiği gün kendiliğinden değişir.

  • 275 Çağrılabilir model — Katalogdaki her satır ad alanlı kimliğiyle çağrılır ve liste herkese açıktır.
  • 19 Model üreticisi — Modeli yapan şirket katalogda adıyla yazılır; listeyi üreticiye göre süzebilirsiniz.
  • 3 Medya türü — Görsel, Video ve Ses — üçü aynı istek biçimini ve aynı faturalama yolunu paylaşır.

Entegrasyonu bağlayan kurallar

Dördü de yazılı bir karar ve dokümantasyon aynısını söylüyor; güncel sınır değerleri orada duruyor, burada değil.

Kimlik doğrulama isteğe bağlı değil
Tahmin edilemez bir URL kimlik doğrulaması değildir. /v1 altındaki her uç anahtarı denetler; herkese açık tek uç model kataloğudur ve sağlayıcının girdiyi indirdiği yol bilerek /v1 dışındadır — kapısı oturum değil imza ve son kullanma anıdır.
Hız sınırı izolatla sıfırlanmaz
Sayaç veritabanında yaşıyor, yani yeni bir izolat başladığında sıfırlanmıyor. Sınır yanıtını gerçek bir yanıt sayın: döngüye girmek yerine bekleyip yeniden deneyin.
Hata kapatır, tahmin etmez
Her hata bir kod taşır ve fail-closed taraf reddetmektir. Hesaplanamayan bir ücret sıfır değil çizgi gösterir, çünkü sıfır ücretsiz diye okunur.
Ücret tam sayıdır, istem arşivlenmez
Tutarlar pico-USD tam sayısıdır — bir doların trilyonda biri — ve para aritmetiğinde kayan nokta hiç kullanılmaz. Üretimin girdisi yalnız çıktısının yanında yaşar ve onunla birlikte silinir; ayrı bir istem günlüğü yoktur.