Runway шығармашылық жиынтығы

Gen-2, Gen-3 және Gen4 модельдерімен кәсіби кескін анимациясы. Кино сапасындағы нәтижелер.

Аутентификация

Runway қызметіне Doitong API арқылы қол жеткізу үшін Doitong API кілтін пайдаланыңыз. Оны GraphQL мутациясына немесе REST API тақырыптарына (headers) қосыңыз.

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

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

Жылдам бастау

Runway Gen4 API қызметімен бірнеше минутта жұмысты бастаңыз. Алғашқы text to video жасау үшін осы қарапайым қадамдарды орындаңыз.

1-қадам: API кілтін алу

Doitong тіркелгісіне тіркеліп, API кілтін жасау үшін бақылау тақтасына (dashboard) өтіңіз.

2-қадам: Алғашқы сұрауды жасау

Алғашқы API сұрауын жасау үшін төмендегі код мысалдарының бірін пайдаланыңыз.

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"
    }
  }
}

Бағалар

Runway Gen4 API кредиттік баға үлгісін пайдаланады. Кредиттер жасалған мазмұнның күрделілігі мен ұзақтығына байланысты жұмсалады.

API соңғы нүктелері

Runway Gen4 API біздің бірыңғай GraphQL соңғы нүктесі арқылы қолжетімді.

GraphQL соңғы нүктесі

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

REST соңғы нүктесі

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

Параметрлер

Runway Gen4 API сұраулары үшін қолжетімді параметрлер:

Жауап форматы

Барлық API жауаптары бірыңғай форматқа сәйкес келеді:

Сәтті жауап

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

Аяқталған жауап

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

Қателерді өңдеу

API стандартты HTTP күй кодтарын пайдаланады және егжей-тегжейлі қате хабарларын қайтарады.

Жиі кездесетін қате кодтары

Қате жауабының форматы

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

Вебхуктар

text to video жасау аяқталған кезде нақты уақыт режимінде хабарландырулар алыңыз.

Вебхуктарды баптау

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

Вебхук деректері (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
  }
}

Вебхук қауіпсіздігі

Барлық вебхук сұраулары тексеру үшін қолтаңба тақырыбын (signature header) қамтиды:

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

Сұрау шектеулері

Әділ пайдалану мен жүйе тұрақтылығын қамтамасыз ету үшін келесі шектеулер қолданылады:

Үздік тәжірибелер

1. Промптарды оңтайландыру

Жақсы нәтиже алу үшін анық, сипаттамалық промптар жазыңыз:

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

2. Асинхронды өңдеуді басқару

Жасау процесі асинхронды. Тиісті сұрау (polling) немесе вебхуктарды енгізіңіз:

// 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. Қателерден кейін қалпына келтіру

Экспоненциалды күту (exponential backoff) арқылы қайталау логикасын енгізіңіз:

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. Кредиттердің жұмсалуын бақылау

Жұмыстың үзілмеуі үшін кредиттердің жұмсалуын қадағалаңыз:

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

Бастауға дайынсыз ба?

Керемет мазмұн жасау үшін Runway Gen4 API қызметін пайдаланатын мыңдаған әзірлеушілерге қосылыңыз