Video ve materyaller

Video Oluştur

Bir video oluşturma görevini başlatın

POST
/v1/videos/generations

Genel Bakış

Video oluşturma işlemi asenkrondur. Başarılı bir oluşturma isteği, bir görev id'si ( task_id ile aynı değer) ve bir poll_url döndürür. status değeri completed veya failed olana kadar bu ID ile GET /v1/tasks/{id} isteğini çağırın, ardından video_url değerini okuyun. Bkz: Video Durumunu Al.

  • Sonuç dosyası 30 gün boyunca saklanır. Daha uzun süre ihtiyacınız varsa indirin; bkz: Veri saklama.
  • Kuyruktaki bir Seedance görevi Görevi İptal Et ile iptal edilebilir.
  • Maliyet, görev kabul edildiğinde rezerve edilebilir ve görev tamamlandığında veya başarısız olduğunda tahsil edilir. Bkz: Faturalandırma ve Fiyatlandırma.
  • Bir zaman aşımından sonra oluşturma isteğini güvenli bir şekilde yeniden denemek için bir Idempotency-Key başlığı gönderin.

Her model kendi operasyonlarını ve alanlarını kabul eder. GET /v1/models/{model} (Modeli Al), her operasyon için kabul edilen alanları, çözünürlükleri, süreleri ve en-boy oranlarını listeler. Bu listenin dışındaki bir alan veya değer, kabul edilen değerlerle birlikte 400 hatası döndürür. duration, resolution, aspect_ratio ve output_audio değerlerini kendiniz ayarlayın: birini atladığınızda, TokenLab operasyon için modelin varsayılan değerini kullanır; eğer hiçbir varsayılan değer eşleşmezse, istek 400 hatası döndürür ve ayarlanması gereken alanı belirtir.

Ses ve Medya Girişi

Ses davranışı, seçilen modele ve işleme bağlıdır. Bir video, ses seçici gösterilmese bile ses içerebilir. Bir seçiciyi atlamak, false göndermekten farklıdır.

  • veo3.1, veo3.1-fast ve veo3.1-lite her zaman ses üretir. output_audio parametresini atlayın veya true gönderin; false değeri reddedilir.
  • wan-2.6 ve wan-2.7 her zaman ses içerir. output_audio parametresini atlayın veya true gönderin. wan-3.0 ve wan-3.0-prime da her zaman ses içerir ve herhangi bir ses seçici kabul etmez.
  • hailuo-h3 yerel ses üretir ve sessize alma anahtarı yoktur. Model detaylarında listelenmeyen bir ses seçici göndermeyin.
  • viduq3-pro ve viduq3-turbo varsayılan olarak ses üretir; sessiz çıktı için output_audio: false (veya audio: false) gönderin. Seedance ve PixVerse modelleri output_audio kabul eder; varsayılana güvenmek yerine bunu açıkça gönderin. Bunu yalnızca listeleyen işlemler için kullanın.
  • audio_url / audio_urls girdi veya referans sesi sağlar. Bunlar ses çıkışı anahtarları değildir. Video düzenleme, hareket aktarımı ve stil aktarımı, girdi ses kaydını koruyabilir; kaynak sesi korumak, onu sessize almamak anlamına gelir.

İzin verilen değerler ve sese bağlı fiyatlar için model detaylarını kontrol edin. Bir model bunları listelediğinde, outputAudio, generate_audio takma adları ve audio boole değeri, birlikte kullanıldıklarında output_audio ile uyumlu olmalıdır. Bir model ailesindeki her sürümün veya işlemin aynı ses kontrollerini paylaştığını varsaymayın.

Görüntüler, videolar ve sesler için herkese açık erişilebilir https URL'leri kullanın ve görev başlayana kadar bunların geçerli kalmasını sağlayın. Bir medya URL'si 8.192 karaktere kadar olabilir. Bazı modeller satır içi data: görüntü URL'lerini de kabul eder (alan başına 2.000.000 karaktere kadar); URL'ler büyük dosyalar için daha güvenilirdir. Aynı istekte satır içi base64 ve uzak URL'leri karıştırmayın.

İstek Gövdesi

modelstringvarsayılan: veo3.1

Video model ID'si. Mevcut video modellerini Modelleri listele (recommended_for=video) ile listeleyin, ardından modeli açıkça gönderin.

PixVerse

  • Model: pixverse-c1, pixverse-v6, pixverse-v5.6
  • İşlemler: text-to-video, image-to-video, start-end-to-video, reference-to-video
  • Ses seçici: output_audio, varsayılan false

TokenLab'de, yukarıdaki PixVerse modelleri operation=video-extension'ı kabul etmez.

HappyHorse

  • Model: happyhorse-1.0
  • İşlemler: text-to-video, image-to-video, reference-to-video, video-to-video
  • Ses seçici: output_audio göndermeyin
promptstring

Videonun metin açıklaması, 10.000 karaktere kadar. Çoğu operasyon bir açıklama gerektirir; model detayları hangilerinin gerektirmediğini belirtir.

operationstring

Oluşturma modu: text-to-video, image-to-video, reference-to-video, start-end-to-video, video-to-video, video-extension veya motion-control. Her model bunlardan yalnızca bazılarını destekler; diğerleri 400 unsupported_operation hatası döndürür. Eğer bu parametreyi belirtmezseniz, TokenLab bunu girdilerden çıkarır: extend_at veya extend_times içeren bir task_id değeri video-extension modunu, referans görselleri veya materyalleri reference-to-video modunu, end_image değeri start-end-to-video modunu, bir video girdisi video-to-video modunu, bir görsel girdisi (image, image_url, image_urls veya start_image) image-to-video modunu, aksi takdirde ise text-to-video modunu tetikler. Uyumsuz alanların erkenden hata vermesini sağlamak için bu parametreyi açıkça gönderin.

image_urlstring

İlk kare görüntüsünün herkese açık erişilebilir URL'si. Seedance 2.0 modelleri, ilk kare olarak ACTIVE bir TokenLab materyali kullanmak için asset://asset-YYYYMMDDHHMMSS-xxxxx formatını da kabul eder. En geniş model desteği için bir https URL'sini tercih edin.

imagestring

Veri URL'si olarak satır içi görüntü (örneğin, data:image/jpeg;base64,...). Sadece bazı modeller bunu kabul eder; image_url daha fazla modelde çalışır.

image_urlsarray

Bu alanı listeleyen modeller için görüntü URL'leri. Sayı sınırları için reference_images kısmına bakın.

reference_imagesarray

reference-to-video için https URL'leri veya veri URL'leri olarak referans görselleri. Sayı sınırı modele bağlıdır:

  • seedance-2.0, seedance-2.0-fast ve seedance-2.0-mini: materyal varlıkları dahil toplam 9 görüntü referansına kadar. Daha fazlası 400 too_many_seedance_reference_images hatası döndürür.
  • seedance-2.5: image_urls ve reference_images genelinde toplam 30 görüntü girişine kadar.
  • grok-imagine-video: 7'ye kadar ve duration 10 saniye ile sınırlıdır. grok-imagine-video-1.5 ve grok-imagine-video-1.5-preview referans görseli almaz.
  • Diğer modeller: model detaylarına bakın. Sınırı aşan bir istek 400 too_many_items hatası döndürür.

Seedance 2.0 modelleri, ACTIVE bir TokenLab materyali için asset://asset-YYYYMMDDHHMMSS-xxxxx formatını da kabul eder. Model seçimi, 4K sınırları ve Mini notları için Seedance 2.0 video modelleri kılavuzuna bakın. grok-imagine-video için referans görsellerini image_url veya image ile birleştirmeyin.

start_imagestring

İlk kare görseli. end_image ile birlikte kullanıldığında istek start-end-to-video olur. end_image olmadan kullanıldığında ise image-to-video olur ve start_image, sözleşmesinde listelenen modellerde image gibi çalışır. Halka açık bir URL veya veri URL'si kabul eder; Seedance 2.0 modelleri ayrıca asset://asset-YYYYMMDDHHMMSS-xxxxx formatını da kabul eder.

end_imagestring

start-end-to-video için son kare görüntüsü. start_image ile aynı girdileri kabul eder.

material_asset_idstring

Materyal Varlığı Oluştur tarafından döndürülen TokenLab Seedance materyal varlık ID'si. Sadece Seedance 2.0 modelleri tarafından kabul edilir; diğer modeller 400 unsupported_seedance_material_asset_model hatası döndürür. Varlık ACTIVE olmalı ve hesabınıza ait olmalıdır. Bu alan genel bir referans girdisidir; ilk kare, son kare veya referans görseli anlamını açıkça atamak için bunun yerine start_image, end_image veya reference_images içinde asset://<material_asset_id> kullanın.

material_asset_idsarray

9 adede kadar TokenLab Seedance materyal varlık ID'si. Bunlar, Seedance 2.0 modellerinin 9 görüntü referansı sınırına dahil edilir.

Sıradan görüntü URL'leri görüntü girdisi olarak iletilir; bunlar yeniden kullanılabilir materyal varlıkları oluşturmaz. Materyal API'si aracılığıyla yeniden kullanılabilir varlıklar oluşturun, ardından bunların TokenLab ID'lerini veya asset://asset-YYYYMMDDHHMMSS-xxxxx URI'lerini kullanın. Eğer açık bir materyal 409 seedance_material_preparing hatası döndürürse, döndürülen inactive_asset_ids değerlerini kontrol edin ve bu materyaller ACTIVE olduktan sonra yeniden deneyin.

video_urlstring

Bu alanı listeleyen modellerde video-to-video, video-extension ve motion-control operasyonları için kaynak videonun herkese açık erişilebilir URL'si.

video_urlsarray

Bu alanı listeleyen modeller için kaynak veya referans videoları. seedance-2.5, video_url ve video_urls genelinde toplam 10 video girişine kadar kabul eder. Diğer modeller için model detaylarına bakın.

audio_urlstring

Bu alanı listeleyen modellerde ses referansı veya ses odaklı operasyonlar için herkese açık ses URL'si. Bu bir ses çıkışı anahtarı değil, bir girdidir.

audio_urlsarray

Bu alanı listeleyen modeller için referans sesi. seedance-2.5, audio_url ve audio_urls genelinde toplam 10 ses girişine kadar kabul eder ve ses referansları içeren ancak metin açıklaması (prompt) içermeyen bir isteğe izin verir. seedance-2.5 için referans sesi ve referans videosu toplamda en fazla 30 saniye sürer.

task_idstring

Bu alanı listeleyen modellerde video-extension için çalışma alanınızdaki önceki bir görevin ID'si. Çalışma alanınıza ait olmayan bir görev 403 task_not_owned hatası döndürür.

extend_atinteger

video-extension işleminin başlayacağı kaynak videonun saniyesi. grok-imagine-video tarafından gereklidir.

extend_timesstring

Bu alanı listeleyen modellerde video-extension işleminde eklenecek saniyeler. grok-imagine-video 6 veya 10 değerlerini alır.

durationinteger

Saniye cinsinden çıktı süresi. İzin verilen değerler modele ve operasyona bağlıdır; diğer değerler 400 invalid_duration hatası döndürür. Seedance modelleri, modelin kendi aralığında seçim yapmasına izin vermek için -1 değerini de kabul eder; bu durumda faturalandırma, görev tamamlanana kadar ihtiyatlı bir şekilde tahmin edilir. Bazı operasyonlar (örneğin motion-control ve grok-imagine-video video-to-video) süre gerektirmez.

secondsinteger

duration için uyumluluk takma adı. Her ikisi de gönderilirse, aynı olmalıdırlar.

aspect_ratiostring

En-boy oranı, örneğin 16:9, 9:16, 1:1, 4:3, 3:4, 21:9 veya adaptive (Seedance). İzin verilen değerler modele ve operasyona bağlıdır; diğer değerler 400 invalid_aspect_ratio hatası döndürür.

resolutionstring

Çıktı çözünürlüğü, örneğin 480p, 720p, 1080p veya 4k. İzin verilen değerler modele ve operasyona bağlıdır; bazı modeller 360p, 540p veya 768p de kullanır. Diğer değerler 400 invalid_resolution hatası döndürür.

output_audioboolean

Bu alanı listeleyen operasyonlar için ses çıkışı seçici. Atlanması durumunda model varsayılanı kullanılır; false değeri, modelin izin verdiği yerlerde sadece sessiz çıktı talep eder. Yukarıdaki ses notlarına ve seçilen model detaylarına bakın.

output_formatstring

seedance-2.5 gibi bu alanı listeleyen modeller için mp4 veya mov kapsayıcı formatı. Bu alanı listelemeyen modeller için atlayın.

return_last_frameboolean

Ayrıca son oluşturulan kareyi last_frame_url olarak döndürür. Sadece Seedance modelleri için.

watermarkboolean

Bu alanı listeleyen modeller (Seedance modelleri) için filigran açma/kapama.

negative_promptstring

Bu alanı listeleyen modeller için oluşturulan videoda kaçınılması gerekenler, 5.000 karaktere kadar.

seedinteger

Bu alanı listeleyen modeller için tekrarlanabilir oluşturma sağlayan tohum (seed) değeri. Seedance 2.0 modelleri rastgele bir tohum için -1 değerini kabul eder; seedance-2.5 bu alanı kabul etmez.

fpsinteger

Bu alanı listeleyen modeller için saniyedeki kare sayısı (1-120).

framesinteger

Bu alanı listeleyen modeller için kare sayısı. Seedance modelleri bunu kabul etmez.

execution_expires_afterinteger

Seedance modelleri için görevin kuyrukta bekleyebileceği saniye süresi (3600 ile 259200 arası).

priorityinteger

Seedance modelleri için 0 ile 9 arası görev önceliği. Bunu service_tier=flex ile birleştirmeyin.

service_tierstring

Seedance 2.0 ve 2.5 modellerinde uyumluluk amaçlı bir "no-op" olarak kabul edilir. flex bu modellerde reddedilir.

safety_identifierstring

Seedance modelleri için son kullanıcı güvenlik tanımlayıcısı (128 karaktere kadar). Atlanırsa, TokenLab sağlandığında user değerini kullanır.

toolsarray

Seedance 2.0 ve 2.5 modelleri için modelin oluşturma sırasında kullanabileceği araçlar. Desteklenen araç {"type": "web_search"} şeklindedir.

userstring

Son kullanıcı için benzersiz bir tanımlayıcı. Seedance modelleri için TokenLab, bu alan atlandığında bunu safety_identifier olarak da kullanır.

Uyumlu Alan İsimleri

  • Birincil alanlar snake_case kullanır: aspect_ratio, output_audio ve reference_images.
  • Uyumluluk için TokenLab ratio, generate_audio, outputAudio, seconds ve referenceImages değerlerini de kabul eder.
  • Bir birincil alan ve takma adı birlikte gönderilirse, değerleri eşleşmelidir. Uyumsuzluk durumunda conflicting_audio_selector, conflicting_duration veya conflicting_aspect_ratio ile 400 hatası döndürülür.

Seedance Parametreleri

Seedance modelleri (seedance-2.0, seedance-2.0-fast, seedance-2.0-mini ve seedance-2.5), yukarıdaki TokenLab alan isimlerini ve seconds, ratio, generate_audio takma adlarını alır. Versiyonlar farklılık gösterir:

Seedance 2.0 modelleriseedance-2.5
Çözünürlükseedance-2.0: 480p, 720p, 1080p, 4k. seedance-2.0-fast ve seedance-2.0-mini: 480p, 720p480p, 720p
Süre-1, 4 ile 15 saniye arası-1, 4 ile 30 saniye arası
En-boy oranı1:1, 3:4, 4:3, 9:16, 16:9, 21:9, adaptiveText-to-video ve reference-to-video için aynı. Image-to-video, start-end, video düzenleme ve extension için adaptive gerekir; video düzenleme ayrıca duration=-1 gerektirir
Çıktı formatımp4mp4 veya mov
seedKabul edilirKabul edilmez
Referans girdileriMateryaller dahil 9 görüntü referansı (materyaller sadece bu modellerde kabul edilir)Toplamda 30 görüntü, 10 video ve 10 ses dosyası

Model detayları, bu değerler için güncel kaynaktır. Varsayılan değerlere güvenmek yerine duration, resolution, aspect_ratio ve output_audio değerlerini açıkça gönderin; modelin recommended_request kısmı tipik bir isteği gösterir.

duration=-1 veya seconds=-1, Seedance'in modelin aralığı içinde çıktı süresini seçmesine izin verir. TokenLab, görev tamamlanmadan önce maliyeti ihtiyatlı bir şekilde tahmin eder, ardından görev tamamlandığında mevcut kullanımdan tahsilatı gerçekleştirir. service_tier=flex ve frames bu modellerde reddedilir.

Seedance Örneği

cURL
curl -X POST "https://api.tokenlab.sh/v1/videos/generations" \
  -H "Authorization: Bearer sk-your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seedance-2.5",
    "prompt": "Sinematik kamera hareketine sahip şık bir ürün tanıtımı",
    "operation": "text-to-video",
    "duration": -1,
    "aspect_ratio": "adaptive",
    "resolution": "720p",
    "output_audio": true
  }'

Yanıt

Sonuçları, hataları, zaman damgalarını ve modeli açıklayan alanlar, görev için mevcut olduklarında döndürülür.

idstring

Görev ID'si. task_id ile aynıdır.

task_idstring

GET /v1/tasks/{id} ile sorgulanacak görev ID'si.

poll_urlstring

Bu görev için durum URL'si, /v1/tasks/{id}. API anahtarınızla çağırın.

statusstring

Görev durumu: pending, processing, completed, failed. Yeni bir görev normalde pending durumundadır.

createdinteger

Görevin oluşturulduğu Unix zaman damgası.

modelstring

Kullanılan model.

billing_transaction_idstring

Tahsilat tamamlandığında faturalandırma işlem ID'si. Görev ID'sinden ayrıdır.

video_urlstring

Video URL'si, sadece oluşturma yanıtı sonucu zaten taşıyorsa mevcuttur. Normalde bunu durum yanıtından okursunuz.

errorstring | object

Görev başarısız olduğunda hata mesajı veya yapılandırılmış hata nesnesi.

Hatalar

Durum ve kodAnlamı
400 invalid_requestBir alan hatalı, aralık dışı veya eksik. error.param alanı isimlendirir. "Set aspect_ratio explicitly" gibi bir mesaj, atlanan alanın bu istek için varsayılanı olmadığını belirtir.
400 unsupported_operation, unsupported_parameter, invalid_resolution, invalid_duration, invalid_aspect_ratio, invalid_parameter_value, too_many_items, prompt_too_longİstek, modelin operasyon için kabul ettikleriyle eşleşmiyor. Hata genellikle kabul edilen değerleri listeler.
400 invalid_parameterBir girdi operasyona uymuyor, örneğin text-to-video ile gönderilen bir görüntü.
400 conflicting_audio_selector, conflicting_duration, conflicting_aspect_ratioBir takma ad ve birincil alanı çelişiyor.
400 unpriceable_selectionSeçilen kombinasyonun fiyatı yok. resolution, duration, aspect_ratio veya ses ayarını değiştirin.
400 too_many_seedance_reference_images, unsupported_seedance_material_asset_modelBir Seedance 2.0 modeli için çok fazla görüntü referansı veya başka bir modele gönderilen materyal.
402Yetersiz bakiye.
403 task_not_ownedtask_id başka bir çalışma alanına ait.
409 seedance_material_preparing, seedance_material_route_unavailableBir materyal henüz ACTIVE değil veya seçilen model sağlanan materyalleri kullanamıyor.
429Hız sınırı aşıldı. Bkz: Hız sınırları.

İstek

curl -X POST "https://api.tokenlab.sh/v1/videos/generations" \
  -H "Authorization: Bearer sk-your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "veo3.1",
    "prompt": "Bahçede yürüyen bir kedi, sinematik aydınlatma",
    "operation": "text-to-video",
    "duration": 4,
    "resolution": "720p",
    "aspect_ratio": "16:9"
  }'

Yanıt

Response
{
  "id": "ldtask_aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
  "task_id": "ldtask_aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
  "poll_url": "/v1/tasks/ldtask_aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
  "status": "pending",
  "model": "veo3.1",
  "created": 1706000000
}

Image to Video

import requests

response = requests.post(
    "https://api.tokenlab.sh/v1/videos/generations",
    headers={"Authorization": "Bearer sk-your-api-key"},
    json={
        "model": "hailuo-2.3",
        "prompt": "Sahne sağlanan görüntüden başlar ve hafif doğal hareketler ekler.",
        "operation": "image-to-video",
        "image_url": "https://example.com/image.jpg",
        "duration": 6,
        "resolution": "768p"
    }
)

Reference to Video

Model özel referans koşullandırmayı desteklediğinde operation=reference-to-video kullanın. Görüntü referansları reference_images içine gider; referans videoları ve sesleri alan modeller video_urls ve audio_urls kullanır. duration sadece oluşturulan çıktı uzunluğunu ayarlar. Referans video girişinin uzunluğunu sınırlamaz. Model başına sayı sınırları için yukarıdaki reference_images kısmına bakın.

import requests

response = requests.post(
    "https://api.tokenlab.sh/v1/videos/generations",
    headers={"Authorization": "Bearer sk-your-api-key"},
    json={
        "model": "veo3.1",
        "prompt": "Hafif doğal hareketler eklerken aynı özne kimliğini, paleti ve çerçeveyi koruyun.",
        "operation": "reference-to-video",
        "reference_images": [
            "https://example.com/ref-a.jpg",
            "https://example.com/ref-b.jpg"
        ],
        "duration": 8,
        "resolution": "720p",
        "aspect_ratio": "9:16"
    }
)

Keyframe Control

İlk ve son kareleri kontrol etmek için start_image ve end_image kullanın:

import requests

response = requests.post(
    "https://api.tokenlab.sh/v1/videos/generations",
    headers={"Authorization": "Bearer sk-your-api-key"},
    json={
        "model": "viduq2-pro",
        "operation": "start-end-to-video",
        "start_image": "https://example.com/day.jpg",
        "end_image": "https://example.com/night.jpg",
        "duration": 5,
        "resolution": "720p"
    }
)

Video to Video

Model birincil girdi olarak mevcut bir videoyu kabul ettiğinde operation=video-to-video kullanın. grok-imagine-video için video_url içinde herkese açık bir HTTPS .mp4 URL'si ve düzenleme prompt'u gönderin; resolution, duration ve aspect_ratio alanlarını atlayın.

import requests

response = requests.post(
    "https://api.tokenlab.sh/v1/videos/generations",
    headers={"Authorization": "Bearer sk-your-api-key"},
    json={
        "model": "grok-imagine-video",
        "operation": "video-to-video",
        "video_url": "https://example.com/source.mp4",
        "prompt": "Orijinal hareketi korurken klibi geliştirin."
    }
)

Video Extension

Önceki bir sonucun devamını getirmek için operation=video-extension kullanın. Çalışma alanınızdaki bir görevin task_id'sini ve bir prompt gönderin; diğer alanlar modele bağlıdır. grok-imagine-video ayrıca extend_at gerektirir ve 6 veya 10 değerinde extend_times alır. veo3.1 ve veo3.1-fast task_id ve prompt alır. Seedance modelleri bu operasyon için video_url, video_urls ve task_id listeler.

Motion Control

Model hem bir özne görüntüsü hem de bir hareket referans videosu beklediğinde operation=motion-control kullanın. image_url ve video_url gönderin; resolution gereklidir.

import requests

response = requests.post(
    "https://api.tokenlab.sh/v1/videos/generations",
    headers={"Authorization": "Bearer sk-your-api-key"},
    json={
        "model": "kling-3.0-motion-control",
        "operation": "motion-control",
        "prompt": "Hareket referansını takip ederken özne kimliğini sabit tutun.",
        "image_url": "https://example.com/subject.png",
        "video_url": "https://example.com/motion.mp4",
        "resolution": "720p"
    }
)

Model Discovery

Genel video envanteri ve desteklenen operasyonlar zamanla değişir. Modele özel bir akış oluşturmadan önce mevcut desteği kontrol etmek için Modeller API'sini kullanın:

curl "https://api.tokenlab.sh/v1/models?recommended_for=video"

curl "https://api.tokenlab.sh/v1/models/veo3.1"

Modele özel operasyonlara veya alanlara güvenmeden önce model detay yanıtını okuyun. video-extension ve motion-control gibi operasyonlar modele özeldir; bu sayfadaki statik örneklere güvenmek yerine güncel kullanılabilirliği oradan teyit edin.

Yetkilendirme

BearerAuth
AuthorizationBearer <token>

API Anahtarı kimlik doğrulaması. API anahtarlarını Dashboard > API > API Keys bölümünden oluşturun veya yönetin.

Konum: header

Başlıklar

X-TokenLab-Delivery-Policy?string

İstek bazlı Teslimat politikası. API anahtarı ve Çalışma Alanı varsayılanlarını geçersiz kılar. Otomatik olarak önce TokenLab Verified dener ve çıktı, istek kabulü veya kalıcı kaynak oluşturma öncesinde bir kez Official seçeneğine geçiş yapabilir.

Geçerli değerler

  • "auto"
  • "verified"
  • "official"
Idempotency-Key?string

Oluşturma isteğinin güvenli bir şekilde yeniden denenmesini sağlayan isteğe bağlı anahtar. Her görev için UUID gibi yeni ve benzersiz bir değer gönderin. Aynı anahtar ve aynı gövde ile yapılan bir yeniden deneme, orijinal oluşturma isteğinin sonucunu (genellikle orijinal görevi) döndürür ve ikinci bir görev oluşturmaz, göndermez veya ücretlendirmez. Daha önce kabul edilmiş bir anahtara sahip farklı bir gövde, 409 hatası ile reddedilir. 255 karakterden uzun bir anahtar yok sayılır ve bu durumda isteğin idempotency koruması olmaz. Bkz: Idempotency anahtarı ile güvenli yeniden deneme.

Uzunluk1 <= length <= 255

İstek gövdesi

application/json

Yanıt

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json