Giriş yapHemen başla
Modele dön API

Cosmos 3 Super

API kılavuzu ve entegrasyon referansı: uç nokta, girdi alanları, fiyatlar, webhook ve hatalar.

Mod

Bu modelin 2 modu var; alanlar, çıktı ve fiyatlar seçili moda göredir. Modu istekte category_id ile seçin (örneklerde hazır). Göndermezseniz girdinize uyan mod, o da yoksa varsayılan mod çalışır.

İstek ve yanıt

POST
https://kolayzeka.com/api/models/cosmos-3-super/generate

Gövde: { "input": {…alanlar}, "category_id"?: sayı, "webhook_url"?: "https://…" }. Alanlar aşağıda; tanımlı olmayan bir alan 422 döner.

cURL · JSON

curl -X POST https://kolayzeka.com/api/models/cosmos-3-super/generate \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
  "input": {
    "prompt": "Prompt",
    "image_url": "https://cdn.example.com/input.jpg",
    "negative_prompt": "The video captures a series of frames showing macroblocking artifacts, chromatic aberration, high-frequency noise, and rolling shutter distortion. It includes static with no motion, motion blur, over-saturation, shaky footage, low resolution, grainy texture, pixelated images, poorly lit areas, underexposed and overexposed scenes, poor color balance, washed out colors, choppy sequences, jerky movements, low frame rate, bit-depth compression artifacts, color banding, unnatural transitions, outdated special effects, fake elements, unconvincing visuals, poorly edited content, jump cuts, hard cut, visual noise, and flickering. It features moiré patterns, edge halos, and temporal aliasing. Furthermore, the content defies common sense, generating illogical scenarios, nonsensical entities, absurd character behaviors, and conceptual paradoxes that violate basic human reasoning and everyday reality. The video looks like a surreal or glitchy hallucination. Overall, the video is of poor quality.",
    "enable_prompt_expansion": true,
    "enable_agentic_generation": false,
    "agentic_max_iterations": 2,
    "agentic_samples_per_iteration": 2,
    "agentic_early_stop": true,
    "image_size": "{\n    \"width\": 832,\n    \"height\": 480\n}",
    "num_frames": 189,
    "frames_per_second": 24,
    "num_inference_steps": 28,
    "guidance_scale": 6,
    "enable_safety_checker": true
  },
  "category_id": 8,
  "webhook_url": "https://your-server.com/hooks/kolayzeka"
}'

cURL · multipart (dosya yükleyerek)

curl -X POST https://kolayzeka.com/api/models/cosmos-3-super/generate \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -F 'input[prompt]=Prompt' \
  -F 'input[negative_prompt]=The video captures a series of frames showing macroblocking artifacts, chromatic aberration, high-frequency noise, and rolling shutter distortion. It includes static with no motion, motion blur, over-saturation, shaky footage, low resolution, grainy texture, pixelated images, poorly lit areas, underexposed and overexposed scenes, poor color balance, washed out colors, choppy sequences, jerky movements, low frame rate, bit-depth compression artifacts, color banding, unnatural transitions, outdated special effects, fake elements, unconvincing visuals, poorly edited content, jump cuts, hard cut, visual noise, and flickering. It features moiré patterns, edge halos, and temporal aliasing. Furthermore, the content defies common sense, generating illogical scenarios, nonsensical entities, absurd character behaviors, and conceptual paradoxes that violate basic human reasoning and everyday reality. The video looks like a surreal or glitchy hallucination. Overall, the video is of poor quality.' \
  -F 'input[enable_prompt_expansion]=true' \
  -F 'input[enable_agentic_generation]=false' \
  -F 'input[agentic_max_iterations]=2' \
  -F 'input[agentic_samples_per_iteration]=2' \
  -F 'input[agentic_early_stop]=true' \
  -F 'input[image_size]={
    "width": 832,
    "height": 480
}' \
  -F 'input[num_frames]=189' \
  -F 'input[frames_per_second]=24' \
  -F 'input[num_inference_steps]=28' \
  -F 'input[guidance_scale]=6' \
  -F 'input[enable_safety_checker]=true' \
  -F 'input[image_url]=@./image_url.jpg' \
  -F 'category_id=8' \
  -F 'webhook_url=https://your-server.com/hooks/kolayzeka'
Üretim asenkrondur. POST, 202 ve status: "queued" döner; sonuç henüz yoktur. Sonucu GET https://kolayzeka.com/api/generations/{id} ile sorgulayın ya da webhook_url verin (aynı nesne gelir). Durumlar: queued → processing → completed | failed. estimated_seconds bu modun geçmiş ortalama süresidir (null olabilir).

1 · POST yanıtı (202)

{
  "data": {
    "id": "9d1c…-uuid",
    "model": "cosmos-3-super",
    "output_type": "video",
    "source": "api",
    "status": "queued",
    "input_data": {
      "prompt": "Prompt",
      "image_url": "https://cdn.example.com/input.jpg",
      "negative_prompt": "The video captures a series of frames showing macroblocking artifacts, chromatic aberration, high-frequency noise, and rolling shutter distortion. It includes static with no motion, motion blur, over-saturation, shaky footage, low resolution, grainy texture, pixelated images, poorly lit areas, underexposed and overexposed scenes, poor color balance, washed out colors, choppy sequences, jerky movements, low frame rate, bit-depth compression artifacts, color banding, unnatural transitions, outdated special effects, fake elements, unconvincing visuals, poorly edited content, jump cuts, hard cut, visual noise, and flickering. It features moiré patterns, edge halos, and temporal aliasing. Furthermore, the content defies common sense, generating illogical scenarios, nonsensical entities, absurd character behaviors, and conceptual paradoxes that violate basic human reasoning and everyday reality. The video looks like a surreal or glitchy hallucination. Overall, the video is of poor quality.",
      "enable_prompt_expansion": true,
      "enable_agentic_generation": false,
      "agentic_max_iterations": 2,
      "agentic_samples_per_iteration": 2,
      "agentic_early_stop": true,
      "image_size": "{\n    \"width\": 832,\n    \"height\": 480\n}",
      "num_frames": 189,
      "frames_per_second": 24,
      "num_inference_steps": 28,
      "guidance_scale": 6,
      "enable_safety_checker": true
    },
    "output_data": null,
    "thumbnail_url": null,
    "credit_cost": 44811,
    "duration": null,
    "estimated_seconds": 12,
    "error_message": null,
    "webhook_url": "https://your-server.com/hooks/kolayzeka",
    "created_at": "2026-06-29T12:00:00.000000Z",
    "updated_at": "2026-06-29T12:00:00.000000Z"
  },
  "success": true
}

2 · Tamamlandı (GET /generations/{id} veya webhook)

{
  "data": {
    "id": "9d1c…-uuid",
    "model": "cosmos-3-super",
    "output_type": "video",
    "source": "api",
    "status": "completed",
    "input_data": {
      "prompt": "Prompt",
      "image_url": "https://cdn.example.com/input.jpg",
      "negative_prompt": "The video captures a series of frames showing macroblocking artifacts, chromatic aberration, high-frequency noise, and rolling shutter distortion. It includes static with no motion, motion blur, over-saturation, shaky footage, low resolution, grainy texture, pixelated images, poorly lit areas, underexposed and overexposed scenes, poor color balance, washed out colors, choppy sequences, jerky movements, low frame rate, bit-depth compression artifacts, color banding, unnatural transitions, outdated special effects, fake elements, unconvincing visuals, poorly edited content, jump cuts, hard cut, visual noise, and flickering. It features moiré patterns, edge halos, and temporal aliasing. Furthermore, the content defies common sense, generating illogical scenarios, nonsensical entities, absurd character behaviors, and conceptual paradoxes that violate basic human reasoning and everyday reality. The video looks like a surreal or glitchy hallucination. Overall, the video is of poor quality.",
      "enable_prompt_expansion": true,
      "enable_agentic_generation": false,
      "agentic_max_iterations": 2,
      "agentic_samples_per_iteration": 2,
      "agentic_early_stop": true,
      "image_size": "{\n    \"width\": 832,\n    \"height\": 480\n}",
      "num_frames": 189,
      "frames_per_second": 24,
      "num_inference_steps": 28,
      "guidance_scale": 6,
      "enable_safety_checker": true
    },
    "output_data": {
      "result": "https://<signed-url>/output.mp4"
    },
    "thumbnail_url": "https://<signed-url>/thumb.jpg",
    "credit_cost": 44811,
    "duration": 4.52,
    "estimated_seconds": 12,
    "error_message": null,
    "webhook_url": "https://your-server.com/hooks/kolayzeka",
    "created_at": "2026-06-29T12:00:00.000000Z",
    "updated_at": "2026-06-29T12:00:05.000000Z"
  },
  "success": true
}

3 · Başarısız

{
  "data": {
    "id": "9d1c…-uuid",
    "model": "cosmos-3-super",
    "output_type": "video",
    "source": "api",
    "status": "failed",
    "input_data": {
      "prompt": "Prompt",
      "image_url": "https://cdn.example.com/input.jpg",
      "negative_prompt": "The video captures a series of frames showing macroblocking artifacts, chromatic aberration, high-frequency noise, and rolling shutter distortion. It includes static with no motion, motion blur, over-saturation, shaky footage, low resolution, grainy texture, pixelated images, poorly lit areas, underexposed and overexposed scenes, poor color balance, washed out colors, choppy sequences, jerky movements, low frame rate, bit-depth compression artifacts, color banding, unnatural transitions, outdated special effects, fake elements, unconvincing visuals, poorly edited content, jump cuts, hard cut, visual noise, and flickering. It features moiré patterns, edge halos, and temporal aliasing. Furthermore, the content defies common sense, generating illogical scenarios, nonsensical entities, absurd character behaviors, and conceptual paradoxes that violate basic human reasoning and everyday reality. The video looks like a surreal or glitchy hallucination. Overall, the video is of poor quality.",
      "enable_prompt_expansion": true,
      "enable_agentic_generation": false,
      "agentic_max_iterations": 2,
      "agentic_samples_per_iteration": 2,
      "agentic_early_stop": true,
      "image_size": "{\n    \"width\": 832,\n    \"height\": 480\n}",
      "num_frames": 189,
      "frames_per_second": 24,
      "num_inference_steps": 28,
      "guidance_scale": 6,
      "enable_safety_checker": true
    },
    "output_data": null,
    "thumbnail_url": null,
    "credit_cost": 0,
    "duration": null,
    "estimated_seconds": 12,
    "error_message": "Sağlayıcı yoğun, lütfen tekrar deneyin.",
    "webhook_url": "https://your-server.com/hooks/kolayzeka",
    "created_at": "2026-06-29T12:00:00.000000Z",
    "updated_at": "2026-06-29T12:00:00.000000Z"
  },
  "success": true
}
  • Sonuç output_data.result alanındadır (imzalı URL, süreli: kalıcı tutmak için kendi depolamanıza indirin).
  • Medya URL'leri imzalıdır ve süresi dolar; eski bir URL için işi tekrar GET edin, taze URL gelir.
  • Geçmiş: GET https://kolayzeka.com/api/generations (en yeni önce, sayfa başına 20, ?page=).

Fiyat ve teklif

Fiyat kredi cinsindendir ve seçtiğiniz seçeneklere (kalite, boyut, süre, adet…) göre değişir. Varsayılan ayarlarla bu mod ≈ 44811 kredi.

POST
https://kolayzeka.com/api/models/cosmos-3-super/quote

Çalıştırmadan, tam bu girdinin fiyatı. Token gerekmez; girdiyi üretimdeki gibi doğrular.

cURL

curl -X POST https://kolayzeka.com/api/models/cosmos-3-super/quote \
  -H "Content-Type: application/json" \
  -d '{"input":{"prompt":"Prompt","image_url":"https://cdn.example.com/input.jpg","negative_prompt":"The video captures a series of frames showing macroblocking artifacts, chromatic aberration, high-frequency noise, and rolling shutter distortion. It includes static with no motion, motion blur, over-saturation, shaky footage, low resolution, grainy texture, pixelated images, poorly lit areas, underexposed and overexposed scenes, poor color balance, washed out colors, choppy sequences, jerky movements, low frame rate, bit-depth compression artifacts, color banding, unnatural transitions, outdated special effects, fake elements, unconvincing visuals, poorly edited content, jump cuts, hard cut, visual noise, and flickering. It features moiré patterns, edge halos, and temporal aliasing. Furthermore, the content defies common sense, generating illogical scenarios, nonsensical entities, absurd character behaviors, and conceptual paradoxes that violate basic human reasoning and everyday reality. The video looks like a surreal or glitchy hallucination. Overall, the video is of poor quality.","enable_prompt_expansion":true,"enable_agentic_generation":false,"agentic_max_iterations":2,"agentic_samples_per_iteration":2,"agentic_early_stop":true,"image_size":"{\n    \"width\": 832,\n    \"height\": 480\n}","num_frames":189,"frames_per_second":24,"num_inference_steps":28,"guidance_scale":6,"enable_safety_checker":true},"category_id":8}'

Yanıt

{
  "success": true,
  "data": {
    "credits": 44811,
    "basis": "per_second",
    "exact": true,
    "mode": {
      "category_id": 8,
      "label": "Image to Video"
    }
  }
}
  • exact: false: fiyat çıktıya bağlı (ör. token, gerçek süre); teklif tipik değerle hesaplanır.
  • Kredi, istek kabul edilince teklif tutarı kadar ayrılır. İş bitince gerçek tutara göre fark düşülür ya da iade edilir; iş başarısız olursa tamamı iade edilir. Kesin tutar: sonuçtaki credit_cost.
  • Bakiye: GET https://kolayzeka.com/api/me → credit_balance. Yetmezse 402 insufficient_credits.

Girdi alanları

input içine gönderilir. Tip etiketi gönderilecek JSON değeridir (string, integer, number, boolean, url, array<url>). Aynı liste makine-okunur olarak GET https://kolayzeka.com/api/ai-models/cosmos-3-super yanıtında.

prompt
zorunlu
string

Prompt · Text prompt describing the motion and scene of the video to generate.

image_url
zorunlu
url
dosya

Image Url · URL of the conditioning first-frame image for the video.

JSON'da herkese açık bir https URL gönderin, ya da dosyayı multipart ile yükleyin: -F 'input[image_url]=@./dosya.jpg'

negative_prompt
isteğe bağlı
string

Negative Prompt · Content to steer the generation away from (artifacts, unwanted motion). Defaults to NVIDIA's recommended i2v negative prompt; pass an empty string to disable.

Varsayılan: "The video captures a series of frames showing macroblocking artifacts, chromatic aberration, high-frequency noise, and rolling shutter distortion. It includes static with no motion, motion blur, over-saturation, shaky footage, low resolution, grainy texture, pixelated images, poorly lit areas, underexposed and overexposed scenes, poor color balance, washed out colors, choppy sequences, jerky movements, low frame rate, bit-depth compression artifacts, color banding, unnatural transitions, outdated special effects, fake elements, unconvincing visuals, poorly edited content, jump cuts, hard cut, visual noise, and flickering. It features moiré patterns, edge halos, and temporal aliasing. Furthermore, the content defies common sense, generating illogical scenarios, nonsensical entities, absurd character behaviors, and conceptual paradoxes that violate basic human reasoning and everyday reality. The video looks like a surreal or glitchy hallucination. Overall, the video is of poor quality." (gönderilmezse bu kullanılır)

enable_prompt_expansion
isteğe bağlı
boolean

Enable Prompt Expansion · If true, the Cosmos3-Nano Reasoner (a VLM that sees the first frame) rewrites the prompt into the dense caption Cosmos3 was trained on. The app starts a local Reasoner by default, or uses COSMOS_PROMPT_UPSAMPLER_BASE_URL when configured. Falls back to the raw prompt if expansion fails.

Varsayılan: true (gönderilmezse bu kullanılır)

enable_agentic_generation
isteğe bağlı
boolean

Enable Agentic Generation · Enable the iterative Cosmos agentic loop: prompt upsampling, candidate video generation, VLM critique of sampled frames, and prompt rewrite. Each candidate is a full render, so this is substantially slower and costlier than a single generation.

Varsayılan: false (gönderilmezse bu kullanılır)

agentic_max_iterations
isteğe bağlı
number

Agentic Max Iterations · Maximum agentic prompt stages when agentic generation is enabled.

Varsayılan: 2 (gönderilmezse bu kullanılır)

Sınırlar: en az 1 · en çok 3

agentic_samples_per_iteration
isteğe bağlı
number

Agentic Samples Per Iteration · Candidate videos to generate and judge per agentic iteration. The best candidate advances to the next rewrite stage.

Varsayılan: 2 (gönderilmezse bu kullanılır)

Sınırlar: en az 1 · en çok 3

agentic_early_stop
isteğe bağlı
boolean

Agentic Early Stop · Stop the agentic loop early when the critic score clears the strict quality threshold.

Varsayılan: true (gönderilmezse bu kullanılır)

image_size
isteğe bağlı
string

Image Size · The size of the generated video. The request is clamped and snapped to the nearest supported NVIDIA tier (256p/480p/720p) and aspect ratio.

Kabul edilen değerler:"square_hd""square""portrait_4_3""portrait_16_9""landscape_4_3""landscape_16_9"

Varsayılan: "{\n \"width\": 832,\n \"height\": 480\n}" (gönderilmezse bu kullanılır)

num_frames
isteğe bağlı
number

Num Frames · Number of frames to generate. More frames yield a longer video.

Varsayılan: 189 (gönderilmezse bu kullanılır)

Sınırlar: en az 5 · en çok 189

frames_per_second
isteğe bağlı
number

Frames Per Second · Frames per second of the output video.

Varsayılan: 24 (gönderilmezse bu kullanılır)

Sınırlar: en az 4 · en çok 60

num_inference_steps
isteğe bağlı
number

Num Inference Steps · Number of denoising steps. More steps yield higher quality but take longer.

Varsayılan: 28 (gönderilmezse bu kullanılır)

Sınırlar: en az 1 · en çok 50

guidance_scale
isteğe bağlı
number

Guidance scale (CFG) · Classifier-free guidance scale. Higher values increase prompt adherence at the cost of diversity.

Varsayılan: 6 (gönderilmezse bu kullanılır)

Sınırlar: en az 0 · en çok 20

seed
isteğe bağlı
number

Seed · The same seed and prompt given to the same model version will produce the same video every time.

enable_safety_checker
isteğe bağlı
boolean

Enable Safety Checker · Enable content moderation for the input prompt and image. Disabling it requires account authorization; unauthorized requests are always checked.

Varsayılan: true (gönderilmezse bu kullanılır)

Kimlik doğrulama

Her istekte Authorization: Bearer YOUR_API_TOKEN. Token'ı Profil sayfasında oluşturun. Katalog ve teklif (/ai-models, /quote) token istemez. Ayrıntılar: geliştirici rehberi.

Webhook

İsteğe bir webhook_url (https) ekleyin; iş bitince oraya imzalı bir POST gelir. Gövde { event, success, data }: data, durum endpoint'inin döndüğü nesnenin aynısıdır. Sorgulamaya gerek kalmaz; uzun işler (video, çok adımlı uygulamalar) için önerilir.

Gelen başlıklar

X-KolayZeka-Event: generation.completed // veya generation.failed

X-KolayZeka-Signature: sha256=<hex>

User-Agent: KolayZeka-Webhook/1.0

İmza = ham gövdenin, hesabınızın webhook imzalama anahtarı ile HMAC-SHA256'sı. Anahtarı Profil sayfasında oluşturun (bir kez gösterilir). Anahtar yoksa webhook gönderilmez.

Doğrulama · Node.js

import crypto from 'node:crypto';

// rawBody: the request body exactly as received (before JSON.parse).
const expected = 'sha256=' + crypto
  .createHmac('sha256', process.env.KOLAYZEKA_WEBHOOK_SECRET)
  .update(rawBody)
  .digest('hex');
const given = req.headers['x-kolayzeka-signature'] ?? '';

if (given.length !== expected.length ||
    !crypto.timingSafeEqual(Buffer.from(expected), Buffer.from(given))) {
  return res.status(401).end();
}

Doğrulama · PHP / Laravel

$expected = 'sha256='.hash_hmac('sha256', $request->getContent(), config('services.kolayzeka.webhook_secret'));

abort_unless(hash_equals($expected, (string) $request->header('X-KolayZeka-Signature')), 401);
  • 2xx dönün. Diğer yanıtlar ve ağ hataları 30 sn arayla en çok 5 kez yeniden denenir.
  • Aynı iş için birden fazla gelebilir: data.id ile tekilleştirin.
  • Özel / iç ağ / bulut-metadata adresleri reddedilir (422 invalid_webhook_url).

Hatalar

Her hata aynı şekildedir: { success: false, code, error, … }. Kodunuzu code'a göre yazın; error insan için mesajdır.

HTTPcodeNe zaman
400
invalid_modeModelin şu an çalıştırılabilir bir modu yok (geçici; başka model deneyin).
401
unauthenticatedBearer token yok, geçersiz ya da iptal edilmiş.
402
insufficient_creditsBakiye yetmiyor. Yanıtta balance (bakiye) ve required (gereken) var.
403
forbiddenBu kaynağa erişim yetkiniz yok.
404
not_foundModel / uygulama / iş yok, aktif değil ya da size ait değil.
405
method_not_allowedEndpoint bu HTTP metodunu kabul etmiyor.
422
validation_failedGirdi şemaya uymuyor. errors alanı: alan → mesajlar.
422
invalid_webhook_urlwebhook_url https değil, çözümlenmiyor ya da özel / iç ağ adresi.
429
rate_limitedHız sınırı aşıldı. retry_after saniye sonra tekrar deneyin.
500
server_errorBeklenmeyen hata. Tekrar denemeden önce listeden (GET /api/generations) işin oluşup oluşmadığına bakın.

402 örneği

{
  "success": false,
  "code": "insufficient_credits",
  "error": "Yetersiz kredi. Bakiye: 40, Gerekli: 55",
  "balance": 40,
  "required": 55
}

422 örneği

{
  "success": false,
  "code": "validation_failed",
  "error": "Doğrulama başarısız oldu.",
  "errors": {
    "quality": [
      "`quality` alanı şunlardan biri olmalıdır: low, medium, high."
    ]
  }
}
Cosmos 3 Super modeline geri dön