Create a Vibe Editing project

About

Call it after complete_upload (POST /v1/uploads/{uploadId}/complete), with the id of the video to edit. The video is chosen here and only here: to edit another video, create another project. The language, the caption style and the shape are the choices the edit starts with; once it is prepared, change them on the timeline with apply_timeline_operations (POST /v1/projects/{projectId}/timeline/operations). Nothing is prepared and no credits are used until you call prepare_timeline (POST /v1/projects/{projectId}/timeline/prepare). Send an Idempotency-Key: a retry without one creates a second project.

Example use

A podcast producer uploads a full episode, creates a Vibe Editing project from it with the language and caption style of the show, and checks the price with estimate_analysis (POST /v1/projects/{projectId}/analyze/estimate) before the edit is prepared.

Endpoint

POST https://api.gpt-video.com/v1/projects/vibe-edit

• Scope clips:write.
• Rate limit 60 requests a minute for each key and 120 for each account, shared by every write call. See rate limits.
• Idempotency-Key is optional.

Parameters

Headers

Body

Send only the fields listed here. Any other field is refused with UNKNOWN_PARAMETER.

Request

Create a Vibe Editing project.

# Create the key once. Send this same key again if you retry this request.
IDEMPOTENCY_KEY=$(uuidgen)
curl -X POST "https://api.gpt-video.com/v1/projects/vibe-edit" \
  -H "Authorization: Bearer $GPT_VIDEO_API_KEY" \
  -H "Idempotency-Key: $IDEMPOTENCY_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "sourceAssetId": "ast_8e21b0d94c6f4a17b358",
    "language": "en",
    "captionStyle": "word-pop",
    "aspect": "9:16",
    "title": "Product demo, edited"
  }'

// Create the key once. Send this same key again if you retry this request.
const idempotencyKey = crypto.randomUUID();
const res = await fetch("https://api.gpt-video.com/v1/projects/vibe-edit", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.GPT_VIDEO_API_KEY}`,
    "Idempotency-Key": idempotencyKey,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    "sourceAssetId": "ast_8e21b0d94c6f4a17b358",
    "language": "en",
    "captionStyle": "word-pop",
    "aspect": "9:16",
    "title": "Product demo, edited"
  }),
});
const data = await res.json();
console.log(data);

import os
import uuid

import requests

# Create the key once. Send this same key again if you retry this request.
idempotency_key = str(uuid.uuid4())
r = requests.post(
    "https://api.gpt-video.com/v1/projects/vibe-edit",
    headers={
        "Authorization": f"Bearer {os.environ['GPT_VIDEO_API_KEY']}",
        "Idempotency-Key": idempotency_key,
    },
    json={
        "sourceAssetId": "ast_8e21b0d94c6f4a17b358",
        "language": "en",
        "captionStyle": "word-pop",
        "aspect": "9:16",
        "title": "Product demo, edited"
    },
)
data = r.json()
print(data)

{
  "method": "tools/call",
  "params": {
    "name": "create_vibe_edit_project",
    "arguments": {
      "sourceAssetId": "ast_8e21b0d94c6f4a17b358",
      "language": "en",
      "captionStyle": "word-pop",
      "aspect": "9:16",
      "title": "Product demo, edited"
    }
  }
}

Response

A successful call answers HTTP 201. Returns a Project object in project.

Fields to check

Response example

{
  "project": {
    "id": "prj_6e2b9d14a7c3f0581e2d",
    "kind": "vibeedit",
    "title": "Product demo, edited",
    "status": "draft",
    "sourceAssetId": "ast_8e21b0d94c6f4a17b358",
    "compositionId": null,
    "settings": null,
    "missingSettings": [],
    "splitScreen": null,
    "streamer": null,
    "redditStory": null,
    "fakeText": null,
    "vibeEdit": {
      "sourceAssetId": "ast_8e21b0d94c6f4a17b358",
      "language": "en",
      "captionStyle": "word-pop",
      "aspect": "9:16",
      "vocabulary": null,
      "prepared": false
    },
    "errorMessage": null,
    "createdAt": "2026-09-01T11:00:00.000Z",
    "updatedAt": "2026-09-01T11:00:00.000Z"
  }
}

{
  "sourceAssetId": "ast_0b1e5c9d3a7f40628e2d",
  "language": "en",
  "captionStyle": "word-pop",
  "aspect": "9:16"
}

{
  "error": {
    "code": "NOT_FOUND",
    "message": "Asset ast_0b1e5c9d3a7f40628e2d not found",
    "hint": "Check the id. An id that belongs to another account is not found either.",
    "requestId": "req_4b7e1a9c3d0f52e86a1b7c04"
  }
}

Errors

Every call can also answer these errors. VALIDATION_FAILED, UNKNOWN_PARAMETER, UNAUTHORIZED, SCOPE_MISSING, IDEMPOTENCY_IN_PROGRESS, PAYLOAD_TOO_LARGE, IDEMPOTENCY_KEY_REUSED, RATE_LIMITED, INTERNAL, UNAVAILABLE.

Cost

No credits are used. The preparation is charged when you call prepare_timeline (POST /v1/projects/{projectId}/timeline/prepare).

Related operations

• complete_upload (POST /v1/uploads/{uploadId}/complete) Complete an upload
• prepare_timeline (POST /v1/projects/{projectId}/timeline/prepare) Prepare an edit
• estimate_analysis (POST /v1/projects/{projectId}/analyze/estimate) Estimate the credits of an analysis or a build
• get_project (GET /v1/projects/{projectId}) Get a project

Questions

Can I change the video of the project later?

No. The video of a Vibe Editing project is chosen when it is created and never changes. Create another project to edit another video, or add more videos to a prepared edit with add_timeline_clip (POST /v1/projects/{projectId}/timeline/clips).

Why is my video refused?

The video must be a video file you uploaded, with a size and a length that can be read, and short enough for the editor; the answer says which of these failed. A longer video can go through Auto Clip, which picks the best moments of it.

View as Markdown