> ## Documentation Index > Fetch the complete documentation index at: https://apidoc.cometapi.com/llms.txt > Use this file to discover all available pages before exploring further. # Tạo một character performance của Runway > Sử dụng CometAPI với API Runway Control a character để khởi chạy các tác vụ character performance từ video tham chiếu, điều khiển biểu cảm khuôn mặt và chuyển động cơ thể. Sử dụng endpoint này để chuyển performance từ một clip tham chiếu sang một hình ảnh nhân vật hoặc video nhân vật. ## Trước khi gọi * Gửi header `X-Runway-Version` bắt buộc, ví dụ `2024-11-06` * Sử dụng `model: act_two` * Cung cấp một asset `character` và một asset `reference` dưới dạng URL HTTPS có thể truy cập được * Bắt đầu với `bodyControl: true` và `expressionIntensity` ở mức vừa phải trước khi tinh chỉnh phong cách ## Tỷ lệ đầu ra | Thiết lập | Giá trị được hỗ trợ | Điểm khởi đầu mặc định | Hành vi ở giới hạn | | --------- | ------------------------------------------------------------------------------------- | ---------------------- | ------------------------------------------------------------------------------- | | `ratio` | `1280:720`, `720:1280`, hoặc tỷ lệ khác được model/phiên bản Runway đã chọn chấp nhận | `1280:720` | Giữ cho asset character và reference gần với hình dạng khung hình được yêu cầu. | ## Luồng tác vụ Tạo tác vụ bằng asset character, asset reference và các thiết lập chuyển động của bạn. Giữ lại `id` được trả về, vì bạn sẽ cần nó để polling về sau. Tiếp tục với [Lấy một tác vụ Runway](./runway-to-get-task-details) cho đến khi tác vụ đạt trạng thái kết thúc và metadata của nhà cung cấp bao gồm đầu ra đã hoàn tất. ## Vai trò đầu vào * `character` là đối tượng bạn muốn tạo animation * `reference` là clip nguồn cung cấp performance khuôn mặt hoặc chuyển động cơ thể * `bodyControl` quyết định liệu việc chuyển động có bao gồm chuyển động cơ thể ngoài việc chuyển biểu cảm hay không * `contentModeration` áp dụng các ngưỡng kiểm duyệt của nhà cung cấp cho yêu cầu ## OpenAPI ````yaml api/openapi/video/runway/official-format/post-control-a-character.openapi.json POST /runwayml/v1/character_performance openapi: 3.1.0 info: title: Control a Character API version: 1.0.0 description: >- Create a Runway character-performance task through the official-format CometAPI route. servers: - url: https://api.cometapi.com security: - bearerAuth: [] paths: /runwayml/v1/character_performance: post: summary: Create a Runway character-performance task description: >- Submit a character asset plus a reference performance clip and receive a task id for later polling. operationId: control_a_character parameters: - name: X-Runway-Version in: header required: true description: Runway version header, for example `2024-11-06`. schema: type: string requestBody: required: true content: application/json: schema: type: object required: - character - reference - bodyControl - expressionIntensity - seed - model - ratio - contentModeration properties: character: type: object description: >- The character to control. You can either provide a video or an image. required: - type - uri properties: type: type: string uri: type: string default: type: video uri: https://your-video-host/source.mp4 reference: type: object description: >- Reference performance clip. Provide `type` (`video`) and `uri` (HTTPS URL). required: - type - uri properties: type: type: string uri: type: string default: type: video uri: https://your-video-host/source.mp4 bodyControl: type: boolean description: Enable body control. default: true expressionIntensity: type: integer description: >- Intensity of the expression transfer. Higher values produce more exaggerated expressions. default: 1 seed: type: integer description: Random seed for reproducible results. default: 1 model: type: string description: The model variant to use. Must be act_two. default: act_two ratio: type: string description: >- Requested output frame shape, for example 1280:720 or 720:1280. Keep the character and reference assets close to the requested frame shape. default: '1280:720' contentModeration: type: object required: - publicFigureThreshold properties: publicFigureThreshold: type: string description: >- Threshold for public-figure detection. Use `auto` for default behavior. default: publicFigureThreshold: auto default: character: type: video uri: https://your-video-host/source.mp4 reference: type: video uri: https://your-video-host/source.mp4 bodyControl: true expressionIntensity: 1 seed: 1 model: act_two ratio: '1280:720' contentModeration: publicFigureThreshold: auto examples: Default: summary: Default value: character: type: video uri: https://your-video-host/source.mp4 reference: type: video uri: https://your-video-host/source.mp4 bodyControl: true expressionIntensity: 3 seed: 4294967295 model: act_two ratio: '1280:720' contentModeration: publicFigureThreshold: auto responses: '200': description: Task accepted. content: application/json: schema: type: object required: - id properties: id: type: string example: id: 5b91e444-c232-deaf-a4d7-8aef3e57336b x-codeSamples: - lang: Shell label: Default source: | curl https://api.cometapi.com/runwayml/v1/character_performance \ -H "Authorization: Bearer $COMETAPI_KEY" \ -H "Content-Type: application/json" \ -d '{ "character": { "type": "video", "uri": "https://your-video-host/character.mp4" }, "reference": { "type": "video", "uri": "https://your-video-host/performance.mp4" }, "model": "act_two", "ratio": "1280:720" }' - lang: Python label: Default source: > import os import requests response = requests.post( "https://api.cometapi.com/runwayml/v1/character_performance", headers={"Authorization": "Bearer " + os.environ["COMETAPI_KEY"]}, json={ "character": { "type": "video", "uri": "https://your-video-host/character.mp4" }, "reference": { "type": "video", "uri": "https://your-video-host/performance.mp4" }, "model": "act_two", "ratio": "1280:720" }, ) task = response.json() print(task["id"]) # poll GET /runwayml/v1/tasks/{id} until the output array appears - lang: JavaScript label: Default source: > const response = await fetch("https://api.cometapi.com/runwayml/v1/character_performance", { method: "POST", headers: { Authorization: `Bearer ${process.env.COMETAPI_KEY}`, "Content-Type": "application/json", }, body: JSON.stringify({ "character": { "type": "video", "uri": "https://your-video-host/character.mp4" }, "reference": { "type": "video", "uri": "https://your-video-host/performance.mp4" }, "model": "act_two", "ratio": "1280:720" }), }); const task = await response.json(); console.log(task.id); // poll GET /runwayml/v1/tasks/{id} until the output array appears components: securitySchemes: bearerAuth: type: http scheme: bearer description: Bearer token authentication. Use your CometAPI key. ````