Update a Reddit story project

About

Only the fields you send change. A new language needs a voice of that language in the same request, because each voice reads one language. The background video can be changed, or removed with null. The changes are used by the next build, which is charged; a change saved while a build waits in the queue is read by that build.

Example use

A script fixes a typo in an English post and switches to another English voice from list_voices (GET /v1/reference/voices). It sends only postBody and voice, then builds the video again with build_reddit_story_video (POST /v1/projects/{projectId}/reddit-story/build).

Endpoint

PATCH https://api.gpt-video.com/v1/projects/{projectId}/reddit-story

• 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

Change the post and the background video.

curl -X PATCH "https://api.gpt-video.com/v1/projects/prj_b71ffef7c27c5ea1cc87/reddit-story" \
  -H "Authorization: Bearer $GPT_VIDEO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "Leaving my own party",
    "postTitle": "Was I wrong to leave my own party early?",
    "subreddit": "r/TrueOffMyChest",
    "backgroundAssetId": "ast_2a2215a18805ec31c629"
  }'

const res = await fetch("https://api.gpt-video.com/v1/projects/prj_b71ffef7c27c5ea1cc87/reddit-story", {
  method: "PATCH",
  headers: {
    "Authorization": `Bearer ${process.env.GPT_VIDEO_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    "title": "Leaving my own party",
    "postTitle": "Was I wrong to leave my own party early?",
    "subreddit": "r/TrueOffMyChest",
    "backgroundAssetId": "ast_2a2215a18805ec31c629"
  }),
});
const data = await res.json();
console.log(data);

import os

import requests

r = requests.patch(
    "https://api.gpt-video.com/v1/projects/prj_b71ffef7c27c5ea1cc87/reddit-story",
    headers={
        "Authorization": f"Bearer {os.environ['GPT_VIDEO_API_KEY']}",
    },
    json={
        "title": "Leaving my own party",
        "postTitle": "Was I wrong to leave my own party early?",
        "subreddit": "r/TrueOffMyChest",
        "backgroundAssetId": "ast_2a2215a18805ec31c629"
    },
)
data = r.json()
print(data)

{
  "method": "tools/call",
  "params": {
    "name": "update_reddit_story_project",
    "arguments": {
      "projectId": "prj_b71ffef7c27c5ea1cc87",
      "title": "Leaving my own party",
      "postTitle": "Was I wrong to leave my own party early?",
      "subreddit": "r/TrueOffMyChest",
      "backgroundAssetId": "ast_2a2215a18805ec31c629"
    }
  }
}

Response

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

Fields to check

Response example

{
  "project": {
    "id": "prj_b71ffef7c27c5ea1cc87",
    "kind": "redditstory",
    "title": "Leaving my own party",
    "status": "ready",
    "sourceAssetId": null,
    "compositionId": "cmp_926433093fafcd62c9cb",
    "settings": null,
    "missingSettings": [],
    "errorMessage": null,
    "splitScreen": null,
    "streamer": null,
    "redditStory": {
      "postBody": "I left my own birthday party after an hour and my sister says I ruined it",
      "author": "u/thrown_away_42",
      "voice": "en-aria",
      "language": "en",
      "captionStyle": "bold-karaoke",
      "vocabulary": null,
      "postTitle": "Was I wrong to leave my own party early?",
      "subreddit": "r/TrueOffMyChest",
      "backgroundAssetId": "ast_2a2215a18805ec31c629"
    },
    "fakeText": null,
    "vibeEdit": null,
    "createdAt": "2026-08-31T22:00:00.000Z",
    "updatedAt": "2026-09-01T11:05:00.000Z"
  }
}

{
  "language": "it"
}

{
  "error": {
    "code": "VALIDATION_FAILED",
    "message": "Send the voice together with the new language: voices belong to one language.",
    "hint": "Fix the request as the message says, then send it again.",
    "requestId": "req_e3a0c7f4b1d8256e9a3c0f71"
  }
}

{
  "subreddit": "r/stories"
}

{
  "error": {
    "code": "CONFLICT",
    "message": "This project is not a Reddit story project. Use the operations of its kind, or analyze_project for an Auto Clip project.",
    "requestId": "req_2b9d6a3f0c7e14b85d2a9f60"
  }
}

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. The next build is charged when you call build_reddit_story_video (POST /v1/projects/{projectId}/reddit-story/build).

Related operations

• create_reddit_story_project (POST /v1/projects/reddit-story) Create a Reddit story project
• build_reddit_story_video (POST /v1/projects/{projectId}/reddit-story/build) Build a Reddit story video
• get_project (GET /v1/projects/{projectId}) Get a project
• list_voices (GET /v1/reference/voices) List the voices

Questions

How do I change the language of a story?

Send the new language and a voice of that language in the same request. list_voices (GET /v1/reference/voices) names the voices of each language.

Does a new background change the price?

No. A Reddit story build costs one credit whatever the background, so the background can be changed at any time.

View as Markdown