TR ▾

Unfiltered Video API Metin: Senaryolar için LLM İş Akışı

Filtresiz video api metin araması yaptıysanız, işe yarar ayrım şudur: render motorunuz pikselleri oluşturur ve bir metin LLM API'si senaryolardan çekim listelerine, altyazılardan açıklamalara kadar her şeyi yazar. Bu kılavuz, OpenAI-uyumlu bir uç noktada bu metin kısmını oluşturur.

Güncellendi

Terminalde akan metin bloklarına dönüşen film şeridi, video için LLM metin iş akışını gösterir

Temel noktalar

  • API sadece metin içerir. Senaryolar, çekim listeleri, altyazılar ve açıklamalar yazar; video, resim veya ses render etmez.
  • Akış, yazılırken size bir taslak senaryo sunar ve JSON modu kodunuzun ayrıştırabileceği bir çekim listesi sağlar.
  • 100.000 token'lık bağlam penceresi, uzun bir transkripti ve talimatlarınızı tek bir istekte tutar.
  • Bir video için tam metin işleme, 1M giriş tokenı başına $0,15 ve 1M çıktı tokenı başına $0,50 fiyatlarla bir santın çok altında bir maliyete sahiptir.

Metnin video hattındaki yeri

Bu sitenin API'si video oluşturmaz. Sadece metin içerir: resim, ses veya video çıktısı yok, gömme yok, ince ayar yok. Bu önemlidir çünkü ifade iki şekilde okunur. Bazı insanlar klip render eden bir model arar ve bunun için ayrı bir video modeline ihtiyacınız vardır. Diğerleri zaten bir render motoruna, stok kütüphaneye veya editöre sahiptir ve yasal ama rahatsız edici konularda içerik reddi yapmadan etrafındaki metni yazan bir LLM'e ihtiyaç duyar: korku senaryoları, gerçek suç yeniden canlandırmaları, karanlık komedi, savaş belgeseli anlatımı, yetişkinler için yazılmış olgun kurgu.

İkinci grup bu makalenin hedef kitlesidir. Pratikte, video etrafındaki metin işi dört göreve ayrılır:

  • Senaryo taslağı hazırlama. Bir taslağı veya not yığınını tutarlı bir sesle anlatıya dönüştürün.
  • Çekim listeleri. Bir senaryoyu; süre, görsel açıklama ve bir anlatım satırı içeren sahnelere bölün; editör kodunuzun okuyabileceği JSON olarak.
  • Altyazılar ve altyazı temizliği. Ham bir transkriptteki noktalama işaretlerini ve konuşmacı etiketlerini düzeltin veya ekranda görünecek metin yazın.
  • Başlıklar, açıklamalar ve etiketler. Kısa çıktılar, çoğu; bu da token başına fiyatlandırmanın size cömert davrandığı yerdir.

Uç noktanın arkasındaki model, bağımsız bir sağlayıcı tarafından yürütülen ve yasal yetişkin kullanım için içerik reddetmeleri olmadan yanıt verecek şekilde ayarlanmış bir açık ağırlıklı modeldir. Bu, tedarikçiler arasında bir yönlendirici değildir ve başkasının modelinin resmi API'si değildir. Tek bir katı sınır geçerlidir: reşit olmayanların yer aldığı cinsel içerik yok. Hala yığınınızın ses ve video kısımlarının nasıl uyduğunu kararsızsanız, video boru hatları sayfası iş bölümünü kapsar.

İstemciyi bağlayın

Uç nokta OpenAI sohbet tamamlama formatını kullanır, bu nedenle iki değeri değiştirdikten sonra herhangi bir OpenAI SDK çalışır: temel URL ve anahtar. Model kimliği uncensored'dir ve kimlik doğrulama standart bir taşıyıcı belirteçtir. İki yöntem vardır: POST /v1/chat/completions ve GET /v1/models.

from openai import OpenAI
import os

client = OpenAI(api_key=os.environ["API_KEY"], base_url="https://api.unfilteredvideo.com/v1")

# sanity check: the model list should include "uncensored"
print([m.id for m in client.models.list().data])
MODEL = "uncensored"

Kabuk tercih ediyorsanız, aynı kontrol tek bir istektir:

curl https://api.unfilteredvideo.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"uncensored","messages":[{"role":"user","content":"Write a two-line cold open for a ghost-story video."}]}'

Bir anahtarı API anahtarı sayfasından alabilirsiniz. Yeni hesaplar tek tıkla $0.50 deneme kredisi talep edebilir; bu 7 gün geçerlidir ve kart gerekmez, bu aşağıdaki her şey için yeterlidir.

Adım 1: senaryo taslağını akış olarak alın

Bir senaryo boru hattındaki en uzun çıktıdır, bu nedenle akış olarak alınmaya değerdir. stream: true ile sunucu, tokenlar üretildikça SSE üzerinden token gönderir ve kullanım bilgileri akışın sonunda ulaşır. Editör aracınız, tam oluşturulana kadar donmak yerine taslağın büyüyerek gösterilmesini sağlayabilir.

from openai import OpenAI
import os

client = OpenAI(api_key=os.environ["API_KEY"], base_url="https://api.unfilteredvideo.com/v1")

outline = """Cold open: abandoned lighthouse at night.
Act 1: the keeper's logbook, last entry torn out.
Act 2: the tide table that does not match the moon.
Close: the lamp turns on by itself."""

stream = client.chat.completions.create(
    model="uncensored",
    stream=True,
    temperature=0.9,
    messages=[
        {"role": "system", "content": "You write narration for short horror videos. Second person, present tense, about 90 seconds spoken."},
        {"role": "user", "content": outline},
    ],
)

script = []
for chunk in stream:
    if chunk.choices and chunk.choices[0].delta.content:
        piece = chunk.choices[0].delta.content
        script.append(piece)
        print(piece, end="", flush=True)
    if getattr(chunk, "usage", None):
        print("\n\ntokens:", chunk.usage.prompt_tokens, chunk.usage.completion_tokens)

script = "".join(script)

Gözden kaçırılması kolay iki detay vardır. İlk olarak, son parça kullanım verisi taşıyabilir ve seçimler taşımayabilir; bu yüzden döngü chunk.choices'i indekslemeden önce kontrol eder. İkinci olarak, akışlı bir istek, akış bitene kadar eşzamanlılık slotunu tutar. Aracınız kullanıcıların aynı anda birkaç taslak başlatmasına izin veriyorsa, her açık akışı limitinize sayın.

Ses, bir dizi boyunca kayar. Kanal kurallarını sistem mesajına koyun ve sabit tutun: anlatıcı kişi ve zamanı, cümle uzunluğu, kaçınılması gereken kelimeler, bir soğuk açılışın nasıl bitmesi gerektiği. Senaryonun asla yapmaması gereken kısa bir liste ekleyin, örneğin sürprizi erken açıklamak. Sabit bir sistem mesajı, token sayılarınızı bir videodan diğerine öngörülebilir kılar, bu da daha sonra bütçe yaparken yardımcı olur.

Tutarlı taslaklar için bir istemi ayarlarken, sabit bir değerle seed ve daha düşük bir temperature geçirin. İlk yaratıcı geçiş için 0.8 ile 1.0 arasında bir sıcaklık daha gevşek, canlı bir anlatım sağlar ve düzeltme aşamasına geçtiğinizde düşürebilirsiniz.

Adım 2: senaryoyu çekim listesine dönüştürün

Editör kodu yapı ister, paragraf değil. JSON modu modeli tek bir JSON nesnesi döndürmeye zorlar ve response_format ile etkinleştirilir. Ayrıca isteminizde JSON kelimesini belirtin ve istediğiniz şekli tanımlayın; ikisi birlikte çıktıyı şekil üzerinde tutar.

import json, os
from openai import OpenAI

client = OpenAI(api_key=os.environ["API_KEY"], base_url="https://api.unfilteredvideo.com/v1")

def shot_list(script_text):
    resp = client.chat.completions.create(
        model="uncensored",
        response_format={"type": "json_object"},
        temperature=0.3,
        messages=[
            {"role": "system", "content": (
                "Return JSON only: {\"shots\": [{\"n\": int, \"seconds\": number, "
                "\"visual\": string, \"narration\": string}]}. "
                "Keep each shot between 3 and 8 seconds."
            )},
            {"role": "user", "content": script_text},
        ],
    )
    data = json.loads(resp.choices[0].message.content)
    return data["shots"]

for s in shot_list(script):
    print(s["n"], s["seconds"], s["visual"][:60])

JSON modu kötü çıktıyı nadir kılar, imkansız değildir. json.loads'i bir try bloğu içine alın, daha düşük bir sıcaklıkla bir kez yeniden deneyin ve güvendiğiniz alanları doğrulayın. Eksik bir seconds değeri içeren bir çekim listesi, biraz kaba bir cümleden çok daha belirgin bir şekilde bir zaman çizelgesini bozar.

visual dizelerini görüntü oluşturucu veya seçiciye iletin. Model konu konusunda dikkatli olması istenmediğinden, kasvetli veya gerilimli sahnelerin betimlemeleri nazik reddiye yerine yazılı özetler olarak döner. Yayınladığınız herhangi bir şey için kendi gözden geçirme adımınızı döngüde tutun.

Adım 3: uzun bir metinden altyazılar ve açıklamalar

Bağlam penceresi 100.000 token'dır; hem istem hem de tamamlama birlikte. Video metin işi için bu cömerttir: uzun bir röportaj transkripti, kanal stil rehberiniz ve üç örnek açıklama tek bir istekte sığar, bu yüzden küçük bir pencereyle yapacağınız gibi parçalara bölüp birleştirmeye gerek kalmaz. Gerçek boyutu tahmin etmek yerine usage alanından kontrol edin ve çıktı için yer bırakın.

import OpenAI from "openai";
import fs from "node:fs";

const client = new OpenAI({
  apiKey: process.env.API_KEY,
  baseURL: "https://api.unfilteredvideo.com/v1",
});

const transcript = fs.readFileSync("interview.txt", "utf8");

const res = await client.chat.completions.create({
  model: "uncensored",
  temperature: 0.4,
  messages: [
    { role: "system", content: "You write video metadata. Reply with a title under 70 characters, a 3 sentence description, and 8 tags separated by commas." },
    { role: "user", content: transcript },
  ],
});

console.log(res.choices[0].message.content);
console.log(res.usage);

Altyazı temizliği için boyuta göre değil süreye göre bölün. Zaman damgalarının dokunulmaz kalmasını söyleyen talimatla ham transkriptin birkaç dakikasını gönderin, sonra birleştirin. Ev stiline uyan ekranda görünecek altyazılara da ihtiyacınız varsa, stil kurallarını sistem mesajına koyun ve çağrılar arasında aynı tutun; bu çıktıları tutarlı kılar ve token sayısını öngörülebilir hale getirir.

Araç çağırma da mevcuttur, örneğin bir çekim listesi yazarken klip kütüphanenizde eşleşen bir klip arayan lookup_asset işlevi gibi kendi işlevlerinizi çağırmak istiyorsanız. Araçları tanımlayın, yanıtta tool_calls'i okuyun, çalıştırın ve sonuçları role: "tool" mesajları olarak geri gönderin.

Hattı şekillendiren sınırlar

Tam anahtar 8 eşzamanlı istek ve dakikada 300 istek izin verir. Deneme anahtarı 2 eşzamanlı ve dakikada 60 izin verir. Gövde limiti 8 MB'tır; bu, metin olarak göndereceğiniz herhangi bir transkriptten çok uzaktır. Bir limiti geçerseniz HTTP 429 alırsınız rate_limited (dakikada çok fazla) veya concurrency (aynı anda çok fazla) hata koduyla. Geçici aşırı yüklenmede de 429 alırsınız, Retry-After: 5 başlığıyla.

Basit kural: herhangi bir 429'da, varsa başlık değerine kadar bekleyin, yoksa birkaç saniye geri çekilin, sonra yeniden deneyin. Başarısız veya reddedilen istekler ücretlendirilmez, bu yüzden yeniden denemeler size maliyetmez. Yanıtlar destek soruları için X-Request-Id ve kalan krediyi kendi aracınızda göstermek için kullanışlı olan X-Balance-USD içerir.

Paralel olarak çok sayıda video render ederken, metin aşamasına 4 ila 6 arasında küçük bir işçi havuzu verin böylece bir taslak patlaması çekim listesi adımını kıtlığa uğratamasın. Akışlar açık kaldıkları sürece eşzamanlılık tüketimine sayılır, bu nedenle yarı okunan bir taslaktan ayrılan bir kullanıcı, tamamlanana kadar bir yuva tutar.

Bir videonun metin tarafının maliyeti

Fiyatlandırma, ön ödemeli kredi ile abonelik olmadan 1M giriş tokenı başına $0,15 ve 1M çıktı tokenı başına $0,50'dir. 90 saniyelik bir video için gerçekçi bir metin geçişi, aşağıda matematik gösterilerek:

AdımGiriş tokenlarıÇıktı tokenlarıMaliyet
Senaryo taslağı6001,200600 × $0,15/1M = $0,00009, artı 1.200 × $0,50/1M = $0,0006, toplam $0,00069
Çekim listesi1,500900$0,000225 + $0,00045 = $0,000675
Başlık, açıklama, etiketler1,800300$0.00027 + $0.00015 = $0.00042

Üç adım, video başına $0.001785'e mal olur. Bin video $1.785 metin demektir. Gerçek istemleriniz bunlardan üç kat daha uzun olsa bile, yazma işin ucuz kısmıdır. $0.50 deneme kredisi başına, $0.50'nin $0.001785'e bölünmesinin yaklaşık 280 ettiği için bu boyutlarda 250'den fazla videoyu karşılar.

Deneme süresi sonunda kredi; kripto para (TRC20 üzerinde USDT veya Base üzerinde USDC) ile yapılan $20 ile $500 arasında herhangi bir tam tutarda yapılan yüklemelerle sağlanır. Daha büyük yüklemeler için bonuslar uygulanır: $50'den +5%, $100'den +10%, $200'den +15%. Kredi süresi dolmaz ve istemler eğitim için kullanılmaz. Fiyatlandırma sayfası detayları listeler ve hızlı başlangıç birkaç dilde aynı istek formatını içerir.

Sorular ve cevaplar

Bu API video oluşturabilir mi?

Hayır. Sadece metin içerir; resim, ses veya video oluşturma yoktur. Senaryolar, çekim listeleri, altyazılar ve açıklamalar için kullanın ve istediğiniz render motoru veya editörle eşleştirin.

Karanlık veya olgun konuları reddeder mi?

Model, yasal yetişkin kullanımı için içerik reddi olmadan yanıt verecek şekilde ayarlanmıştır; bu nedenle korku, suç ve yetişkinler için olgun kurgu işe yarar. Reşit olmayanlar içeren cinsel içerik kesinlikle kabul edilmez.

Hangi model ID'sini ve base URL'i kullanmalıyım?

Herhangi bir OpenAI uyumlu SDK ile https://api.unfilteredvideo.com/v1 temel URL'sini ve uncensored model kimliğini kullanın. Taşıyıcı belirteci ile kimlik doğrulaması yapın.

Ücretsiz bir katman var mı?

Ücretsiz katman yoktur. Yeni kullanıcılar 7 gün boyunca geçerli olan, kart gerekmeden talep edilebilen tek seferlik $0.50 deneme kredisi alabilir; ardından bakiyenizi $20'den itibaren yükleyebilirsiniz.

Anahtarınız tek bir formun uzağında

Bir hesap oluşturun, anahtarı kopyalayın ve base URL'yi değiştirin. Kurulum bu kadar basit.

API anahtarı al