Referans

POST /v1/videos

Metin istemiyle OpenAI biçiminde sesli bir klip üret: SDK'nın videos yöntemleri yalnızca temel URL değiştirilerek çalışır. Kuyruğa al, kontrol et, bir kez indir; sonra klip silinir.

6 Kasım 2026 tarihinde kontrol edildi

Bir klip üret

import os
import time
from openai import OpenAI

client = OpenAI(
    base_url="https://nokeep.ai/v1",
    api_key=os.environ["NOKEEP_API_KEY"],
)

clip = client.videos.create(
    model="minimax-h3-max-turbo",
    prompt="Waves breaking on a rocky coast at dusk",
    seconds="5",
    size="1280x720",
)

while clip.status in ("queued", "in_progress"):
    time.sleep(5)
    clip = client.videos.retrieve(clip.id)

if clip.status == "completed":
    client.videos.download_content(clip.id).write_to_file("clip.mp4")

Modeller

Model	En iyi kullanım	480p saniye başına	768p saniye başına	1080p saniye başına
minimax-h3-max-turbo	Hızlı, sesli. Başlamak için bu.	0,045 $	0,07 $	0,14 $
minimax-h3-max	Turbo'dan daha fazla adım; daha ince ayrıntı için, sesli.	0,09 $	0,14 $	0,28 $

İstediğin saniye kadar ödersin. İki model de 5 ile 15 saniye arasında, sesli klip üretir.

İstek

Alan	Alır	Ne yapar
`model`	Zorunlu	Yukarıdaki model kimliklerinden biri.
`prompt`	Zorunlu, en fazla 10.000 karakter	Ne çekileceği; modele olduğu gibi gönderilir. Sınırın üstü reddedilir, asla kesilmez.
`seconds`	5 ile 15 arası	Klibin uzunluğu; sayı ya da metin olarak. Varsayılan 5. OpenAI'nin 4'ü reddedilir; 8 ve 12 çalışır.
`size`	`WIDTHxHEIGHT`	En yakın çözünürlüğü ve biçimi seçer. 1280x720, 16:9 oranında 768p olur ve ödediğin de budur.
`resolution`	`480p`, `768p` ya da `1080p`	Fiyatı belirler ve `size` yerine geçer. Varsayılan 768p.
`aspect_ratio`	16:9, 21:9, 4:3, 1:1, 3:4, 9:16	`size` yerine geçer. Varsayılan 16:9.

JSON ya da OpenAI SDK'larının kullandığı multipart form gönder. seed gibi diğer alanlar atılır ve x-nokeep-ignored içinde adlarıyla belirtilir. input_reference gibi bir resim ya da klip taşıyan alan 400 unsupported_input ile reddedilir: bu modeller yalnızca metinle çalışır. OpenAI’ın Python SDK’sı videos yöntemlerinde, OpenAI’ın kendi video hizmetiyle ilgili bir kullanımdan kaldırma uyarısı gösterir. Bu, bize yapılan çağrıları etkilemez; tür denetleyicisi de model kimliğini işaretleyebilir.

Klibin rotaları

Rota	Ne yapar
`POST /v1/videos`	Bir klibi kuyruğa alır ve fiyatını tutar.
`GET /v1/videos/{id}`	Klibin nerede olduğunu söyler. Her birkaç saniyede kontrol et.
`GET /v1/videos/{id}/content`	MP4 dosyası. Bir kez çalışır, sonra klip modelin barındırıcısından silinir. İndirme yarıda kesilirse yeniden iste.
`DELETE /v1/videos/{id}`	Bitmiş bir klibi indirmeden siler. Hâlâ render edilen bir klip `409 video_not_ready` yanıtı verir.
`GET /v1/videos`	Hesabın son klipleri.

Klip nesnesi

JSON

{
  "id": "video_8f3a…",
  "object": "video",
  "model": "minimax-h3-max-turbo",
  "status": "completed",
  "progress": 100,
  "created_at": 1793960000,
  "completed_at": 1793960030,
  "expires_at": 1794042800,
  "seconds": "5",
  "size": "1366x768",
  "resolution": "768p",
  "aspect_ratio": "16:9",
  "error": null,
  "downloaded": false,
  "expired": false,
  "usage": {
    "nokeep_credits": 350
  }
}

status queued, in_progress, completed ya da failed olabilir.
progress, klip bitene kadar 0'dır, sonra 100 olur. Model aradaki hiçbir şeyi bildirmez.
size, çözünürlükten ve biçimden hesaplanır; bu yüzden dosya birkaç pikselle farklı olabilir.

Ne ödersin

Klibin tam fiyatı kuyruğa alındığında tutulur; satın aldığın kredilerden ve anahtarın günlük sınırından.
Klip bittiğinde tahsil edilir; indirip indirmemen fark etmez.
Başarısız olan klip ücretlendirilmez ve durumu bunu söyler.

Klip nerede kalır

Bitmiş bir klip, modelin barındırıcısında, özel bir katmanda 23 saate kadar bekler. Tek indirmenden sonra ya da sen silince orada silinir. Dosyayı biz asla tutmayız; bu süre geçince 410 video_gone yanıtı döner. Klip hakkındaki kendi kaydımız kimliği, anahtarı, modeli, uzunluğu, çözünürlüğü, biçimi, kredileri ve zamanları tutar; prompt'u asla tutmaz. 48 saat sonra silinir.

İçerik, sınırlar ve hatalar

Dört sert sınır geçerli kalır: reşit olmayanları içeren cinsel içerik, gerçek kişilerin cinsel içeriği, kitlesel ölüme yol açan zarar ve gerçek bir kişiyi hedef alma. Bunlardan birini aşan prompt 422 hard_limit alır ve ücretlendirilmez. Modelin barındırıcısı da bir isteği reddedebilir; bu 422 content_refused olur, o da ücretsizdir. Bkz. Sert sınırlar.

Bir anahtar dakikada 20 klip kuyruğa alabilir; toplam 120 istek içinde kalır ve aynı anda 10 klibi render edebilir. Bunun ötesi 429 rate_limited döner. Her kodu hatalar sayfası listeler.

Kodunu hiçbir şey harcamadan kontrol etmek için anahtar olarak sk-nokeep-test gönder. Her kontrolü çalıştırır, klibi hemen bitmiş olarak video_test ile bildirir ve dosyası boştur.

API anahtarı al Ücretsiz test anahtarını dene: sk-nokeep-test

Aklınızda ne var?