Update a fake text project

About

Use it to change a choice made at creation. Only the fields you send change, and the video of the project is rebuilt with them. The look of the chat is written to the project and to its story. Changing the language keeps the words of the story and gives the default voice of the new language to each side whose voice is of the other language. Send backgroundAssetId null to remove the background.

Example use

An agency that tested the WhatsApp look on a story switches the project to iMessage and a new background video, then exports again with create_export (POST /v1/compositions/{compositionId}/exports).

Endpoint

PATCH https://api.gpt-video.com/v1/projects/{projectId}/fake-text

• 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.
• No Idempotency-Key.

Parameters

Path

Body

The body is optional. Send only the fields you want to change.

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

Request

Show the chat as WhatsApp.

curl -X PATCH "https://api.gpt-video.com/v1/projects/prj_ba8b07a88bfb14585459/fake-text" \
  -H "Authorization: Bearer $GPT_VIDEO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "theme": "whatsapp"
  }'

const res = await fetch("https://api.gpt-video.com/v1/projects/prj_ba8b07a88bfb14585459/fake-text", {
  method: "PATCH",
  headers: {
    "Authorization": `Bearer ${process.env.GPT_VIDEO_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    "theme": "whatsapp"
  }),
});
const data = await res.json();
console.log(data);

import os

import requests

r = requests.patch(
    "https://api.gpt-video.com/v1/projects/prj_ba8b07a88bfb14585459/fake-text",
    headers={
        "Authorization": f"Bearer {os.environ['GPT_VIDEO_API_KEY']}",
    },
    json={
        "theme": "whatsapp"
    },
)
data = r.json()
print(data)

{
  "method": "tools/call",
  "params": {
    "name": "update_fake_text_project",
    "arguments": {
      "projectId": "prj_ba8b07a88bfb14585459",
      "theme": "whatsapp"
    }
  }
}

Response

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

Fields to check

Response example

{
  "project": {
    "id": "prj_ba8b07a88bfb14585459",
    "kind": "faketext",
    "title": "The surprise party",
    "status": "ready",
    "sourceAssetId": null,
    "compositionId": "cmp_47e9069a7ece7041f213",
    "settings": null,
    "missingSettings": [],
    "splitScreen": null,
    "streamer": null,
    "redditStory": null,
    "fakeText": {
      "theme": "whatsapp",
      "language": "en",
      "voiceover": true,
      "backgroundAssetId": "ast_8ac5d8b97546145cdbf6",
      "storyId": "cnv_a744d5ef6cc005e19285"
    },
    "vibeEdit": null,
    "errorMessage": null,
    "createdAt": "2026-08-31T22:10:00.000Z",
    "updatedAt": "2026-09-01T11:05:00.000Z"
  }
}

{
  "backgroundAssetId": null
}

{
  "project": {
    "id": "prj_ba8b07a88bfb14585459",
    "kind": "faketext",
    "title": "The surprise party",
    "status": "ready",
    "sourceAssetId": null,
    "compositionId": "cmp_47e9069a7ece7041f213",
    "settings": null,
    "missingSettings": [],
    "splitScreen": null,
    "streamer": null,
    "redditStory": null,
    "fakeText": {
      "theme": "imessage",
      "language": "en",
      "voiceover": true,
      "backgroundAssetId": null,
      "storyId": "cnv_a744d5ef6cc005e19285"
    },
    "vibeEdit": null,
    "errorMessage": null,
    "createdAt": "2026-08-31T22:10:00.000Z",
    "updatedAt": "2026-09-01T11:05:00.000Z"
  }
}

{
  "theme": "whatsapp"
}

{
  "error": {
    "code": "CONFLICT",
    "message": "This project is not a fake text project. Stories exist only in fake text projects.",
    "requestId": "req_8c3f1a6e2d0b47959e4a1c7b"
  }
}

{
  "theme": "whatsapp"
}

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

Errors

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

Cost

No credits are used.

Related operations

• create_fake_text_project (POST /v1/projects/fake-text) Create a fake text project
• get_fake_text_story (GET /v1/projects/{projectId}/story) Get the story of a fake text project
• get_project (GET /v1/projects/{projectId}) Get a project

Questions

What happens to the voices when I change the language?

A side whose voice is of the other language goes back to the default voice of the new language. The lines keep their old voices until create_fake_text_voices (POST /v1/projects/{projectId}/story/voices) makes new ones.

Does turning voiceover off delete the voices?

No. The video stops playing them, and they come back if you turn voiceover on again.

View as Markdown