Runway Yaratıcı Paket

Gen-2, Gen-3 ve Gen4 modelleri ile profesyonel görsel animasyonu. Sinematik kalitede sonuçlar.

Kimlik Doğrulama

Runway platformuna Doitong API üzerinden erişmek için Doitong API anahtarınızı kullanın. Bu anahtarı GraphQL mutasyonuna veya REST API başlıklarına ekleyin.

// GraphQL Header
{
  "Authorization": "Bearer YOUR_API_KEY"
}

// REST Header
"X-API-Key": "YOUR_API_KEY"

Hızlı Başlangıç

Runway Gen4 API ile birkaç dakika içinde başlayın. İlk text to video içeriğinizi oluşturmak için bu basit adımları izleyin.

1. Adım: API Anahtarınızı Alın

Bir Doitong hesabı oluşturun ve API anahtarı oluşturmak için panelinize gidin.

2. Adım: İlk İsteğinizi Gönderin

İlk API çağrınızı yapmak için aşağıdaki kod örneklerinden birini kullanın.

curl -X POST https://api.doitong.com/graphql \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Idempotency-Key: unique-request-id-123" \
  -d '{
    "query": "mutation Generate($input: GenerateInput!) { generate(input: $input) { id status type provider url metadata creditCost } }",
    "variables": {
      "input": {
        "type": "VIDEO",
        "provider": "runway",
        "input": {
          "text": "A serene landscape with mountains and a lake at sunset"
        },
        "options": {
          "duration": 5,
          "aspectRatio": "16:9"
        }
      }
    }
  }'

const response = await fetch('https://api.doitong.com/graphql', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'Authorization': 'Bearer YOUR_API_KEY',
    'Idempotency-Key': 'unique-request-id-123'
  },
  body: JSON.stringify({
    query: `
      mutation Generate($input: GenerateInput!) {
        generate(input: $input) {
          id
          status
          type
          provider
          url
          metadata
          creditCost
        }
      }
    `,
    variables: {
      input: {
        type: 'VIDEO',
        provider: 'runway',
        input: {
          text: 'A serene landscape with mountains and a lake at sunset'
        },
        options: {
          duration: 5,
          aspectRatio: '16:9'
        }
      }
    }
  })
});

const data = await response.json();
console.log('Result:', data.data.generate);

import requests
import json

url = "https://api.doitong.com/graphql"
headers = {
    "Content-Type": "application/json",
    "Authorization": "Bearer YOUR_API_KEY"
}

query = """
mutation Generate($input: GenerateInput!) {
  generate(input: $input) {
    id
    status
    type
    provider
    url
    metadata
    creditCost
  }
}
"""

variables = {
    "input": {
        "type": "VIDEO",
        "provider": "runway",
        "input": {
            "text": "A serene landscape with mountains and a lake at sunset"
        },
        "options": {
            "duration": 5,
            "aspectRatio": "16:9"
        }
    }
}

response = requests.post(url, json={
    "query": query,
    "variables": variables
}, headers=headers)

data = response.json()
print("Result:", data["data"]["generate"])

mutation Generate($input: GenerateInput!) {
  generate(input: $input) {
    id
    status
    type
    provider
    url
    metadata
    creditCost
    createdAt
  }
}

# Variables
{
  "input": {
    "type": "VIDEO",
    "provider": "runway",
    "input": {
      "text": "A serene landscape with mountains and a lake at sunset"
    },
    "options": {
      "duration": 5,
      "aspectRatio": "16:9",
      "version": "gen-4",
      "quality": "high"
    }
  }
}

Fiyatlandırma

Runway Gen4 API, kredi tabanlı bir fiyatlandırma modeli kullanır. Krediler, oluşturulan içeriğin karmaşıklığına ve süresine göre tüketilir.

API Uç Noktaları

Runway Gen4 API hizmetine birleşik GraphQL uç noktamız üzerinden erişilebilir.

GraphQL Uç Noktası

POST https://api.doitong.com/graphql

REST Uç Noktası

POST https://api.doitong.com/v1/text_to_video

Parametreler

Runway Gen4 API istekleri için kullanılabilir parametreler:

Yanıt Formatı

Tüm API yanıtları tutarlı bir format izler:

Başarılı Yanıt

{
  "data": {
    "generatevideo": {
      "id": "abc123xyz",
      "status": "processing",
      "url": null,
      "webhookUrl": "https://your-webhook.com/callback",
      "createdAt": "2024-01-01T00:00:00Z"
    }
  }
}

Tamamlanmış Yanıt

{
  "data": {
    "generatevideo": {
      "id": "abc123xyz",
      "status": "completed",
      "url": "https://cdn.doitong.com/outputs/abc123xyz.mp4",
      "duration": 5,
      "createdAt": "2024-01-01T00:00:00Z"
    }
  }
}

Hata Yönetimi

API, standart HTTP durum kodlarını kullanır ve ayrıntılı hata mesajları döndürür.

Yaygın Hata Kodları

Hata Yanıt Formatı

{
  "errors": [
    {
      "message": "Insufficient credits for this operation",
      "extensions": {
        "code": "INSUFFICIENT_CREDITS",
        "creditsRequired": 100,
        "creditsAvailable": 50
      }
    }
  ]
}

Webhook'lar

text to video oluşturma işleminiz tamamlandığında gerçek zamanlı bildirimler alın.

Webhook Kurulumu

Include a <code>webhookUrl</code> parameter in your request to receive a POST notification when processing is complete.

Webhook Verisi (Payload)

{
  "id": "abc123xyz",
  "status": "completed",
  "url": "https://cdn.doitong.com/outputs/abc123xyz.mp4",
  "service": "runway",
  "createdAt": "2024-01-01T00:00:00Z",
  "completedAt": "2024-01-01T00:01:00Z",
  "metadata": {
    "duration": 5,
    "width": 1920,
    "height": 1080
  }
}

Webhook Güvenliği

Tüm webhook istekleri doğrulama için bir imza başlığı içerir:

X-Doitong-Signature: sha256=abc123...

İstek Limitleri

Adil kullanım ve sistem kararlılığını sağlamak için aşağıdaki limitler geçerlidir:

En İyi Uygulamalar

1. Komutlarınızı Optimize Edin

En iyi sonuçlar için net ve açıklayıcı komutlar (prompt) yazın:

• Be specific about visual elements, style, and mood
• Include details about lighting, camera angles, and composition
• Avoid contradictory or impossible requests

2. Asenkron İşlemleri Yönetin

Oluşturma işlemi asenkrondur. Uygun sorgulama (polling) veya webhook mekanizmalarını kurun:

// Polling example
async function pollStatus(jobId) {
  let status = 'processing';
  while (status === 'processing') {
    await sleep(2000); // Wait 2 seconds
    const result = await checkJobStatus(jobId);
    status = result.status;
  }
  return result;
}

3. Hata Kurtarma

Üstel geri çekilme (exponential backoff) ile yeniden deneme mantığını uygulayın:

async function retryWithBackoff(fn, maxRetries = 3) {
  for (let i = 0; i < maxRetries; i++) {
    try {
      return await fn();
    } catch (error) {
      if (i === maxRetries - 1) throw error;
      await sleep(Math.pow(2, i) * 1000);
    }
  }
}

4. Kredi Kullanımını İzleyin

Kesinti yaşamamak için kredi tüketiminizi takip edin:

• Check credit balance before large batch operations
• Set up alerts for low credit thresholds
• Implement credit-aware request queuing

Başlamaya Hazır mısınız?

Harika içerikler oluşturmak için Runway Gen4 API kullanan binlerce geliştiriciye katılın