PixVerse Video Uzatma

01

Genel Bakış

Desteklenen bir modelle video uzatma uç noktasını kullanın. Durumunu almak için döndürülen Görev Kimliğini kullanın ya da aşağıda belgelenen teslimatlar için callback_url sağlayın.

Hızlı başlangıç

Bir API anahtarı oluşturun ve RUNAPI_API_KEY olarak ayarlayın.
Desteklenen bir model seçin ve gövdesi o modelin şemasıyla eşleşen bir POST isteği gönderin.
Döndürülen görev kimliğini saklayın, ardından bir terminal durumuna ulaşana kadar yoklama yapın ya da aşağıda belgelenen geri çağırmaları işleyin.

POST /api/v1/pixverse/extend_video

Temel URL: https://runapi.ai
API sürümü: v1
Kimlik doğrulama: Authorization: Bearer YOUR_API_TOKEN

02

Desteklenen modeller

Güncel fiyatlandırma, hız sınırları ve ticari kullanım ayrıntıları için bir model sayfası açın.

PixVerse

03

İstek şeması

JSON gövdesi

Alanlar ve izin verilen değerler seçili modele göre değişir. Sağlandığında, callback_url aşağıda belgelenen Görev teslimatlarını alır.

pixverse-v68 alan

callback_urlstring

İsteğe bağlı

Asenkron bildirimler için webhook URL'si.

duration_secondsinteger

Zorunlu

Saniye cinsinden süre.

Varsayılan: 5 Aralık: 1 - 15

enable_audioboolean

İsteğe bağlı

Senkronize ses oluşturmayı etkinleştirin.

İzin verilen değerler: true, false Varsayılan: false

modelstring

Zorunlu

Model tanımlayıcısı.

output_resolutionstring

Zorunlu

Çıktı çözünürlüğü.

İzin verilen değerler: 360p, 540p, 720p, 1080p Varsayılan: 720p

promptstring

Zorunlu

Video devam açıklaması.

Aralık: 3 - 5000

seedinteger

İsteğe bağlı

Rastgele tohum.

Aralık: 0 - 2147483647

source_task_idstring

Zorunlu

Uzatılacak tamamlanmış PixVerse video görevi kimliği.

04

Kabul oluştur

HTTP 202

POST /api/v1/pixverse/extend_video

Yanıt şeması

JSON

{
  "properties": {
    "billing": {
      "properties": {
        "refund": {
          "oneOf": [
            {
              "properties": {
                "refunded_at": {
                  "type": "string"
                }
              },
              "required": [
                "refunded_at"
              ],
              "type": "object",
              "unevaluatedProperties": false
            },
            {
              "enum": [
                null
              ]
            }
          ]
        },
        "reservation": {
          "oneOf": [
            {
              "properties": {
                "amount_cents": {
                  "type": "integer"
                }
              },
              "required": [
                "amount_cents"
              ],
              "type": "object",
              "unevaluatedProperties": false
            },
            {
              "enum": [
                null
              ]
            }
          ]
        },
        "settlement": {
          "oneOf": [
            {
              "properties": {
                "amount_micro_cents": {
                  "type": "integer"
                },
                "charged_amount_cents": {
                  "type": "integer"
                }
              },
              "required": [
                "charged_amount_cents",
                "amount_micro_cents"
              ],
              "type": "object",
              "unevaluatedProperties": false
            },
            {
              "enum": [
                null
              ]
            }
          ]
        }
      },
      "required": [
        "reservation",
        "settlement",
        "refund"
      ],
      "type": "object",
      "unevaluatedProperties": false
    },
    "id": {
      "type": "string"
    },
    "status": {
      "enum": [
        "processing"
      ],
      "type": "string"
    },
    "task_replayed": {
      "type": "boolean"
    }
  },
  "required": [
    "id",
    "status",
    "billing"
  ],
  "type": "object",
  "unevaluatedProperties": false
}

Yanıt örneği

JSON

{
  "billing": {
    "refund": null,
    "reservation": null,
    "settlement": null
  },
  "id": "tsk_reference_demo",
  "status": "processing"
}

05

Yoklama işleniyor

HTTP 200

GET /api/v1/pixverse/extend_video/:id

Yanıt şeması

JSON

{
  "properties": {
    "billing": {
      "properties": {
        "refund": {
          "oneOf": [
            {
              "properties": {
                "refunded_at": {
                  "type": "string"
                }
              },
              "required": [
                "refunded_at"
              ],
              "type": "object",
              "unevaluatedProperties": false
            },
            {
              "enum": [
                null
              ]
            }
          ]
        },
        "reservation": {
          "oneOf": [
            {
              "properties": {
                "amount_cents": {
                  "type": "integer"
                }
              },
              "required": [
                "amount_cents"
              ],
              "type": "object",
              "unevaluatedProperties": false
            },
            {
              "enum": [
                null
              ]
            }
          ]
        },
        "settlement": {
          "oneOf": [
            {
              "properties": {
                "amount_micro_cents": {
                  "type": "integer"
                },
                "charged_amount_cents": {
                  "type": "integer"
                }
              },
              "required": [
                "charged_amount_cents",
                "amount_micro_cents"
              ],
              "type": "object",
              "unevaluatedProperties": false
            },
            {
              "enum": [
                null
              ]
            }
          ]
        }
      },
      "required": [
        "reservation",
        "settlement",
        "refund"
      ],
      "type": "object",
      "unevaluatedProperties": false
    },
    "id": {
      "type": "string"
    },
    "status": {
      "enum": [
        "processing"
      ],
      "type": "string"
    }
  },
  "required": [
    "id",
    "status",
    "billing"
  ],
  "type": "object",
  "unevaluatedProperties": false
}

Yanıt örneği

JSON

{
  "billing": {
    "refund": null,
    "reservation": null,
    "settlement": null
  },
  "id": "tsk_reference_demo",
  "status": "processing"
}

06

Yoklama tamamlandı

HTTP 200

GET /api/v1/pixverse/extend_video/:id

Yanıt şeması

JSON

{
  "properties": {
    "billing": {
      "properties": {
        "refund": {
          "oneOf": [
            {
              "properties": {
                "refunded_at": {
                  "type": "string"
                }
              },
              "required": [
                "refunded_at"
              ],
              "type": "object",
              "unevaluatedProperties": false
            },
            {
              "enum": [
                null
              ]
            }
          ]
        },
        "reservation": {
          "oneOf": [
            {
              "properties": {
                "amount_cents": {
                  "type": "integer"
                }
              },
              "required": [
                "amount_cents"
              ],
              "type": "object",
              "unevaluatedProperties": false
            },
            {
              "enum": [
                null
              ]
            }
          ]
        },
        "settlement": {
          "oneOf": [
            {
              "properties": {
                "amount_micro_cents": {
                  "type": "integer"
                },
                "charged_amount_cents": {
                  "type": "integer"
                }
              },
              "required": [
                "charged_amount_cents",
                "amount_micro_cents"
              ],
              "type": "object",
              "unevaluatedProperties": false
            },
            {
              "enum": [
                null
              ]
            }
          ]
        }
      },
      "required": [
        "reservation",
        "settlement",
        "refund"
      ],
      "type": "object",
      "unevaluatedProperties": false
    },
    "id": {
      "type": "string"
    },
    "status": {
      "enum": [
        "completed"
      ],
      "type": "string"
    },
    "videos": {
      "items": {
        "properties": {
          "url": {
            "type": "string",
            "x-runapi-generated-media": true
          }
        },
        "required": [
          "url"
        ],
        "type": "object",
        "unevaluatedProperties": false
      },
      "type": "array"
    }
  },
  "required": [
    "id",
    "status",
    "videos",
    "billing"
  ],
  "type": "object",
  "unevaluatedProperties": false
}

Yanıt örneği

JSON

{
  "billing": {
    "refund": null,
    "reservation": null,
    "settlement": null
  },
  "id": "tsk_reference_demo",
  "status": "completed",
  "videos": [
    {
      "url": "https://file.runapi.ai/reference-video.mp4"
    }
  ]
}

07

Yoklama başarısız oldu

HTTP 200

GET /api/v1/pixverse/extend_video/:id

Yanıt şeması

JSON

{
  "properties": {
    "billing": {
      "properties": {
        "refund": {
          "oneOf": [
            {
              "properties": {
                "refunded_at": {
                  "type": "string"
                }
              },
              "required": [
                "refunded_at"
              ],
              "type": "object",
              "unevaluatedProperties": false
            },
            {
              "enum": [
                null
              ]
            }
          ]
        },
        "reservation": {
          "oneOf": [
            {
              "properties": {
                "amount_cents": {
                  "type": "integer"
                }
              },
              "required": [
                "amount_cents"
              ],
              "type": "object",
              "unevaluatedProperties": false
            },
            {
              "enum": [
                null
              ]
            }
          ]
        },
        "settlement": {
          "oneOf": [
            {
              "properties": {
                "amount_micro_cents": {
                  "type": "integer"
                },
                "charged_amount_cents": {
                  "type": "integer"
                }
              },
              "required": [
                "charged_amount_cents",
                "amount_micro_cents"
              ],
              "type": "object",
              "unevaluatedProperties": false
            },
            {
              "enum": [
                null
              ]
            }
          ]
        }
      },
      "required": [
        "reservation",
        "settlement",
        "refund"
      ],
      "type": "object",
      "unevaluatedProperties": false
    },
    "error": {
      "type": "string"
    },
    "id": {
      "type": "string"
    },
    "status": {
      "enum": [
        "failed"
      ],
      "type": "string"
    }
  },
  "required": [
    "id",
    "status",
    "error",
    "billing"
  ],
  "type": "object",
  "unevaluatedProperties": false
}

Yanıt örneği

JSON

{
  "billing": {
    "refund": null,
    "reservation": null,
    "settlement": null
  },
  "error": "Task processing failed.",
  "id": "tsk_reference_demo",
  "status": "failed"
}

08

Müşteri geri çağırması: tamamlandı

HTTP 200

POST callback_url

Yanıt şeması

JSON

{
  "properties": {
    "id": {
      "type": "string"
    },
    "status": {
      "enum": [
        "completed"
      ],
      "type": "string"
    },
    "videos": {
      "items": {
        "properties": {
          "url": {
            "type": "string",
            "x-runapi-generated-media": true
          }
        },
        "required": [
          "url"
        ],
        "type": "object",
        "unevaluatedProperties": false
      },
      "type": "array"
    }
  },
  "required": [
    "id",
    "status",
    "videos"
  ],
  "type": "object",
  "unevaluatedProperties": false
}

Yanıt örneği

JSON

{
  "id": "tsk_reference_demo",
  "status": "completed",
  "videos": [
    {
      "url": "https://file.runapi.ai/reference-video.mp4"
    }
  ]
}

09

Müşteri geri çağırması: başarısız oldu

HTTP 200

POST callback_url

Yanıt şeması

JSON

{
  "properties": {
    "error": {
      "oneOf": [
        {
          "type": "string"
        },
        {
          "properties": {
            "code": {
              "type": "string"
            },
            "limit_cents": {
              "type": "integer"
            },
            "message": {
              "type": "string"
            },
            "reset_at": {
              "format": "date-time",
              "type": [
                "string",
                "null"
              ]
            },
            "used_cents": {
              "type": "integer"
            },
            "window": {
              "enum": [
                "1h",
                "1d",
                "7d",
                "daily",
                "weekly",
                "monthly",
                "lifetime"
              ],
              "type": "string"
            }
          },
          "required": [
            "code",
            "message"
          ],
          "type": "object",
          "unevaluatedProperties": false
        }
      ]
    },
    "id": {
      "type": "string"
    },
    "status": {
      "enum": [
        "failed"
      ],
      "type": "string"
    }
  },
  "required": [
    "id",
    "status",
    "error"
  ],
  "type": "object",
  "unevaluatedProperties": false
}

Yanıt örneği

JSON

{
  "error": {
    "code": "generation_failed",
    "message": "Task processing failed."
  },
  "id": "tsk_reference_demo",
  "status": "failed"
}

10

Hatalar

HTTP 401

POST /api/v1/pixverse/extend_video

Yanıt şeması

JSON

{
  "properties": {
    "error": {
      "description": "İnsan tarafından okunabilir hata mesajı.",
      "type": "string"
    }
  },
  "required": [
    "error"
  ],
  "type": "object",
  "unevaluatedProperties": false
}

Yanıt örneği

JSON

{
  "error": "Authentication required"
}

11

Hatalar

HTTP 401

GET /api/v1/pixverse/extend_video/:id

Yanıt şeması

JSON

{
  "properties": {
    "error": {
      "description": "İnsan tarafından okunabilir hata mesajı.",
      "type": "string"
    }
  },
  "required": [
    "error"
  ],
  "type": "object",
  "unevaluatedProperties": false
}

Yanıt örneği

JSON

{
  "error": "Authentication required"
}

12

Hatalar

HTTP 400

POST /api/v1/pixverse/extend_video

Yanıt şeması

JSON

{
  "oneOf": [
    {
      "properties": {
        "error": {
          "description": "İnsan tarafından okunabilir hata mesajı.",
          "type": "string"
        }
      },
      "required": [
        "error"
      ],
      "type": "object",
      "unevaluatedProperties": false
    },
    {
      "properties": {
        "error": {
          "description": "İnsan tarafından okunabilir doğrulama özeti.",
          "type": "string"
        },
        "errors": {
          "additionalProperties": {
            "items": {
              "type": "string"
            },
            "type": "array"
          },
          "description": "Herkese açık istek alanına göre anahtarlanan doğrulama mesajları; her alan için insan tarafından okunabilir dizelerden oluşan bir dizi içerir.",
          "type": "object"
        }
      },
      "required": [
        "error",
        "errors"
      ],
      "type": "object",
      "unevaluatedProperties": false
    }
  ]
}

Yanıt örneği

JSON

{
  "error": "model must be one of: pixverse-v6"
}

13

Hatalar

HTTP 402

POST /api/v1/pixverse/extend_video

Yanıt şeması

JSON

{
  "properties": {
    "error": {
      "description": "İnsan tarafından okunabilir hata mesajı.",
      "type": "string"
    }
  },
  "required": [
    "error"
  ],
  "type": "object",
  "unevaluatedProperties": false
}

Yanıt örneği

JSON

{
  "error": "Insufficient balance"
}

14

Hatalar

HTTP 429

POST /api/v1/pixverse/extend_video

Yanıt şeması

JSON

{
  "properties": {
    "error": {
      "description": "İnsan tarafından okunabilir hata mesajı.",
      "type": "string"
    }
  },
  "required": [
    "error"
  ],
  "type": "object",
  "unevaluatedProperties": false
}

Yanıt örneği

JSON

{
  "error": "API key credit limit exceeded"
}

15

Hatalar

HTTP 409

POST /api/v1/pixverse/extend_video

Yanıt şeması

JSON

{
  "properties": {
    "error": {
      "description": "İnsan tarafından okunabilir hata mesajı.",
      "type": "string"
    }
  },
  "required": [
    "error"
  ],
  "type": "object",
  "unevaluatedProperties": false
}

Yanıt örneği

JSON

{
  "error": "The request uses features that are not supported for the selected model"
}

16

Hatalar

HTTP 429

POST /api/v1/pixverse/extend_video

Yanıt şeması

JSON

{
  "properties": {
    "error": {
      "description": "İnsan tarafından okunabilir hata mesajı.",
      "type": "string"
    }
  },
  "required": [
    "error"
  ],
  "type": "object",
  "unevaluatedProperties": false
}

Yanıt örneği

JSON

{
  "error": "Rate limit reached. Please retry later."
}

17

Hatalar

HTTP 503

POST /api/v1/pixverse/extend_video

Yanıt şeması

JSON

{
  "properties": {
    "error": {
      "description": "İnsan tarafından okunabilir hata mesajı.",
      "type": "string"
    }
  },
  "required": [
    "error"
  ],
  "type": "object",
  "unevaluatedProperties": false
}

Yanıt örneği

JSON

{
  "error": "Service under maintenance, please try again later"
}

18

Hatalar

HTTP 504

POST /api/v1/pixverse/extend_video

Yanıt şeması

JSON

{
  "properties": {
    "error": {
      "description": "İnsan tarafından okunabilir hata mesajı.",
      "type": "string"
    }
  },
  "required": [
    "error"
  ],
  "type": "object",
  "unevaluatedProperties": false
}

Yanıt örneği

JSON

{
  "error": "The request timed out"
}

19

Hatalar

HTTP 404

GET /api/v1/pixverse/extend_video/:id

Yanıt şeması

JSON

{
  "properties": {
    "error": {
      "description": "İnsan tarafından okunabilir hata mesajı.",
      "type": "string"
    }
  },
  "required": [
    "error"
  ],
  "type": "object",
  "unevaluatedProperties": false
}

Yanıt örneği

JSON

{
  "error": "Task with id 'tsk_reference_demo' not found"
}

20

Oluşturulan Kod Örnekleri

Doğrudan cURL kullanın veya diliniz için bir SDK yükleyin. Her örnek, bu başvuruda gösterilen doğrulanmış isteği gönderir.

Yükle

Shell

pip install runapi-pixverse

PYTHON

import os
from runapi.pixverse import PixVerseClient

client = PixVerseClient(api_key=os.environ["RUNAPI_API_KEY"])
task = client.extend_video.create(
  model="pixverse-v6",
  source_task_id="550e8400-e29b-41d4-a716-446655440000",
  prompt="Continue the scene as the lanterns rise.",
  output_resolution="720p",
  duration_seconds=5
)

Yükle

Shell

npm install @runapi.ai/pixverse

JAVASCRIPT

import { PixVerseClient } from "@runapi.ai/pixverse";

const client = new PixVerseClient({ apiKey: process.env.RUNAPI_API_KEY });
const task = await client.extendVideo.create({
  "model": "pixverse-v6",
  "source_task_id": "550e8400-e29b-41d4-a716-446655440000",
  "prompt": "Continue the scene as the lanterns rise.",
  "output_resolution": "720p",
  "duration_seconds": 5
});

CURL

curl -X POST https://runapi.ai/api/v1/pixverse/extend_video \
  -H 'Authorization: Bearer YOUR_API_TOKEN' \
  -H 'Content-Type: application/json' \
  -d '{"model":"pixverse-v6","source_task_id":"550e8400-e29b-41d4-a716-446655440000","prompt":"Continue the scene as the lanterns rise.","output_resolution":"720p","duration_seconds":5}'

Yükle

Shell

go get github.com/runapi-ai/pixverse-sdk/go@latest

GO

package main

import (
  "context"
  "log"
  "os"

  "github.com/runapi-ai/core-sdk/go/option"
  pixverse "github.com/runapi-ai/pixverse-sdk/go/pixverse"
)

func main() {
  client, err := pixverse.NewClient(option.WithAPIKey(os.Getenv("RUNAPI_API_KEY")))
  if err != nil {
    log.Fatal(err)
  }

  task, err := client.ExtendVideo.Create(context.Background(), pixverse.ExtendVideoParams{
    SourceTaskID: "550e8400-e29b-41d4-a716-446655440000",
    CommonVideoParams: pixverse.CommonVideoParams{Model: pixverse.Model("pixverse-v6"), Prompt: "Continue the scene as the lanterns rise.", OutputResolution: pixverse.OutputResolution("720p"), DurationSeconds: 5},
  })
  if err != nil {
    log.Fatal(err)
  }
  _ = task
}

21

PixVerse Video Uzatma

Genel Bakış

Hızlı başlangıç

Uç Nokta

Desteklenen modeller

İstek şeması

Kabul oluştur

Yanıt örneği

Yoklama işleniyor

Yanıt örneği

Yoklama tamamlandı

Yanıt örneği

Yoklama başarısız oldu

Yanıt örneği

Müşteri geri çağırması: tamamlandı

Yanıt örneği

Müşteri geri çağırması: başarısız oldu

Yanıt örneği

Hatalar

Yanıt örneği

Hatalar

Yanıt örneği

Hatalar

Yanıt örneği

Hatalar

Yanıt örneği

Hatalar

Yanıt örneği

Hatalar

Yanıt örneği

Hatalar

Yanıt örneği

Hatalar

Yanıt örneği

Hatalar

Yanıt örneği

Hatalar

Yanıt örneği

Oluşturulan Kod Örnekleri

Yükle

İlgili Kılavuzlar