List aicut characters
list_charactersReturns the characters saved on this aicut account, newest first, one page at a time: kind: "uploaded" entries the user made from their own photos and kind: "cast_member" entries generated as AI Video Story cast. Each carries an id, a display name, a portrait image_url where one exists and, for cast members, the visual world. Read-only: it creates nothing and spends nothing. WHEN: the user wants to reuse a character ('same cast as last time') or you want to show what the account has. world DOES NOT IDENTIFY THE SERIES and nothing on these rows does (a world is shared by many series), so 'the same cast as last time' cannot be answered from this list alone, and that is a MONEY point: never pick members for a story create by matching world to the series. Name the candidates to the user and let them confirm, or draft a fresh cast with generate_cast (free): a wrong pick is only discovered after the frames are drawn and charged. WHAT EACH KIND CAN DO: cast_member ids are what generate_story_video takes as cast_member_ids; a cast member's portrait image_url is usually one of this account's own images and can go into generate_* media fields (members on a series' stock preset carry a shared url those fields refuse). uploaded ids are what generate_video takes as character_ids (a flat 0.2 tokens on top of the video); their portrait urls are NOT accepted by media fields (a saved character is not an upload_media upload): pass the id. Paging: cursor from the previous next_cursor while has_more is true.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | How many to return, 1 to 100. Defaults to 50. | |
| cursor | No | The previous response's `next_cursor`. Omit for the first page. |