animate_licensed_final
ChatGPTUse this when the user has named one exact license and one still to animate into a licensed clip: an approved Finals source, a delivered still adapted from a final, or — only when the license carries the reference-clip grant — a delivered still created from a reference. If they have not named whether to animate an approved Finals source or a delivered still, ask which they mean; a still being on screen is not the answer. Provide sourceId for an approved Finals source, or parentAttemptId plus parentOutputIndex for a delivered still, never both; the origin is read off the row, never declared. This produces ONE watermarked clip with generated audio, not still candidates. H3 Max is the default model; Seedance 2.5 is an explicit challenger choice but remains disabled. Clip length and frame size are quality choices; leave them unset for the shortest, standard clip. Video with generated audio has to be part of what the talent granted — if it is not, Reflections says so and nothing runs.
ask_license_question
ChatGPTCall it every time you ask the person something about an open license draft, with kind, draftId and question set to exactly what you asked: the Reflections card shows your question beside the draft, and an answer typed there arrives as the person's message. Where get_license_interview's rules call offer_choices, pass offer_choices' arguments here as they are, and the card draws the web interview's chips. Display only: it records nothing and grants nothing.
check_licensed_edit
ChatGPTUse this to check the input and selected changes against the live license before staging a render. This is a free deterministic check: it does not interpret the prompt, start a render, or create a durable record; it reads a new scene's words only for a logo or other brand mark when brandItems is not given and nothing rides. Pass brandItems as you would to stage the render: an item no approved image of the license shows is refused as missing_image. Prompt interpretation runs when the person starts the generation job. Only check prompt text the user has already seen in this conversation. The verdict is advisory: the live check at start decides, and an admitted check is not authorization. A creationProfile license requires a reference primary; contributions and other approved references can ride as extras. On other licenses a final may start an edit and a reference starts creation. If more than one approved image could fit — a final to change, or a reference for a new scene — and the person has not named one, ask which they mean before checking. This tool never starts anything: when it admits, stage the same prompt and moves for the person — render_source_confirmation from an approved source or reference, render_attempt with suggestedPrompt to change a candidate that attempt delivered — and let them start it from the card. Those two start from different images, and "another version" does not choose between them: when the person asks for one without pointing at a result, ask which they mean before you stage it.
choose_license_kinds
ChatGPTSets what the brand may use and make in a talent's own license, or what a brand will make in its own draft, as the person chose in the card: the web's first questions, offered from the kinds open on Reflections. Only the person's own choice: the card calls it.
choose_license_photos
ChatGPTSets the images a draft holds, as the person chose them in the card: the photos a talent's own license is made from, or the images a brand shows the talent beside its draft. Only the person's own choice: the card's picker calls it.
confirm_license_review
ChatGPTConfirms the license as Review shows it: the person's own click in the review card, never the model's.
contribute_licensed_source
ChatGPTUse this when the user offers ONE image file from the Reflections component as a contribution to one exact license. PNG only, at most 5 MB: the server reads the signature and refuses any other format, so convert before offering. Set attested only when the person has said they hold the rights. The file is unusable until the talent approves it as a source, and she does that in her own Reflections account: the brand cannot approve it and must not be sent anywhere to try. Report the wait, do not give them a step. Approval never makes it a reference.
contribute_licensed_source_from_chat
ChatGPTUse this when the user offers ONE image that already lives in this ChatGPT conversation or file library as a contribution to one exact license. ChatGPT supplies the file and Reflections downloads it directly. PNG only, at most 5 MB: the server reads the signature and refuses any other format, so convert before offering. Set attested only when the person has said they hold the rights. The file is unusable until the talent approves it as a source, and she does that in her own Reflections account: the brand cannot approve it and must not be sent anywhere to try. Report the wait, do not give them a step. Approval never makes it a reference.
download_released_final
ChatGPTUse this when the user has named one exact license and released final and wants a short-lived human download link.
finalize_vault_intake
ChatGPTUse this when the Reflections component has sent a file's bytes: the file becomes a Library asset, or the answer says why not. Idempotent: a lost answer is asked again. Component-only.
get_attempt
ChatGPTUse this to READ one attempt under one named license — its state, exact prompt, verdict, or why it failed. It renders nothing. When the person should SEE the attempt, its progress or its delivered candidates, call render_attempt instead; that card is also the only place a refinement can be started. Pass attemptId, or operationId when the card reported a render it could not confirm started: it finds the attempt that operation created, if any. It also returns a delivered still's watermarked candidates for you to look at; use it, not render_attempt, when you only need to see them.
get_certificate
ChatGPTUse this when the user wants the released evidence summary for one certificate under one exact license.
get_license_interview
ChatGPTCall this before you ask anything for an open license draft, and again when a save says the draft changed. It returns the rules Reflections' own assistant follows for this kind of draft and the draft's state as that assistant reads it: what is open and why, every term already written, and the guide. Follow the rules for every turn of the interview; write with save_license_draft. It draws nothing.
get_license_workspace
ChatGPTUse this when the user has named one exact license and needs its current rights, final meter, revision, and active work. For a brand seat only; a talent reads a license she issued with get_talent_license. Read can and rules together: allowedMoves alone is not the complete grant. A creationProfile permits new depictions within the signed campaign and conditions. A render starts from one approved image and can combine up to two more of the license's approved images with it: contributions, and other references when it starts a new scene from a reference. A contribution never starts one.
get_talent_license
ChatGPTUse this as the TALENT to read one license you issued, after a notification about it or when you name it: the brand, campaign, status and window, and what the brand submitted that waits for your decision, each with the page where you decide. Read only: a talent never starts work under her own license, and decisions are made on Reflections. A brand reads its licenses with get_license_workspace instead.
get_vault_asset
ChatGPTUse this when the Reflections component opens one of the account's own files in the viewer: what it is, its uses, where it has been used, and a signed picture for the stage. A download URL is minted only on the person's Download press. Component-only.
list_finals
ChatGPTUse this only to READ about finals — counts, states, slot numbers — for one exact license. It renders nothing. When the user should SEE their finals, call render_release instead; it shows every final as pictures and needs no final id.
list_licensed_sources
ChatGPTUse this to READ the approved sources and references for one exact license; it renders nothing, so when the person should SEE them call render_licensed_sources instead, and to start a render from one call render_source_confirmation. Read get_license_workspace first: on a creationProfile license, references anchor new images and approved contribution finals are supporting inputs only, never edit or video sources. Up to two listed images other than the one a render starts from can ride with it in extraSourceIds: contributions, and other references when it starts a new scene from a reference. An edit of a final takes no reference. On other licenses, finals may anchor edits or video when granted. A reference starts new images through start_licensed_creation; it is not animated directly, though a still created from it can be when the license grants that.
list_my_licenses
ChatGPTUse this when the user needs to choose or review a Reflections license as a brand; it lists brand seats, never the licenses a talent issued. It renders nothing: when the person should pick one, call render_license_picker so they choose from the card rather than from a list you retyped. A preferred license is display ordering only and never authorizes a write.
list_recent_license_activity
ChatGPTUse this when the user wants the recent brand-safe activity for one exact license; request later pages only when needed.
open_vault_intake
ChatGPTUse this when the Reflections component starts adding one file to the account's own Library: it opens the intake and returns the signed storage ticket the component sends the bytes to itself. Component-only.
read_license_pdf
ChatGPTReads a PDF the person attached into an open draft: a campaign brief for a draft for a talent, or the talent's contract for her own license. It fills only empty fields and says what it filled and what is missing. The draft card's attach control calls it, with a PDF from the person's computer or one from ChatGPT's files.
read_vault
ChatGPTUse this when the Reflections component draws the account's own Library: one page of its files for a search, filters and a sort, newest first under their month, with the counts the toolbar needs. Component-only.
read_vault_bin
ChatGPTUse this when the Reflections component shows Recently deleted: the account's own files waiting to be erased, with the days left before each one is. Component-only.
read_vault_selection
ChatGPTUse this when the Reflections component selects files in the account's own Library: every file matching its filters (Select all, at most 5,000), or the named files as they are now. Component-only.
refine_licensed_edit
ChatGPTUse this when the user has named one exact license and one delivered candidate and wants a checked refinement of THAT candidate through the Reflections pipeline. The refinement builds on that candidate's pixels, while start_licensed_edit begins again from the original source and start_licensed_creation begins again from a reference. When the user asked for another version without naming a candidate, ask which they mean before choosing; the presence of a delivered candidate is not the answer. This starts a new render, not an adjustment of the last run.
refresh_vault_intake_token
ChatGPTUse this when the Reflections component's resumable upload outlives its ticket: a fresh ticket for the same intake, or null when every byte is already there. Component-only.
render_all_finals
ChatGPTUse this to show every final across the person's licenses, grouped by license, as watermarked pictures with their release state. The Reflections home opens it; it starts nothing.
render_attempt
ChatGPTUse this when the user should see the exact prompt, progress, verdict, hold, failure, or the delivered candidates for one attempt under one exact license. Asked to change a candidate this attempt delivered — the person pointed at that result — call this with suggestedPrompt, suggestedMoves and that candidate's suggestedOutputIndex (zero-based: candidate 1 is 0): the card selects it and fills its refinement field with your exact words, and the person starts it from there. When you recommend a candidate this attempt delivered, call this in that same turn with your proposed improvement to it, so the person can start it from the card. Never write the prompt out for the person to copy; if this answers that nothing was staged, say why. A refinement builds on that candidate's own pixels rather than beginning again from the licensed asset it came from, so this is the wrong card for a request to render the brief again from the licensed assets: that is render_licensed_sources, then render_source_confirmation. "Another version" and "a new version" name neither on their own — when the person asks for one without pointing at a result, ask which they mean before you stage it. Your own recommendation after a delivery is not such a request. To animate a still from this attempt, call this only when they named that delivered still; otherwise ask which they mean before showing a card. Candidates are not finals: a delivered candidate becomes a final only through submit_final. Asked to see finals, call render_release — showing the last attempt's candidates and naming which one was released answers a different question.
render_change_request_confirmation
ChatGPTUse this when the user has named one exact license and proposed one exact right, preference removal, final-cap increase, or Video grant, but must visibly confirm the external request before it is sent. The card's control is what sends it — you hold no verb that does — so stage the exact request here, name the control, and stop.
render_contribution_offer
ChatGPTUse this when the person wants to add an image of their own to one exact license — a product, a setting, a photo of another person they hold the rights to — or asks to upload, attach or include a new asset. This card takes the file: the person confirms the rights and offers one PNG from their device or their ChatGPT files, and the card's control is what sends the offer. Never tell the person you cannot upload or take a file; show this card. The talent approves an offer in her own Reflections account, and the brand cannot. Once approved, render_licensed_sources lists it as an asset to composite; it never becomes a reference. When a render needs a product or brand mark that no approved image of the license shows, call this with needed naming it, and stage that render only once the contribution is approved. An image the license already has is never offered again: to use it, call render_licensed_sources so the person marks it to combine.
render_final_confirmation
ChatGPTUse this when the user has named one exact delivered candidate and must visibly confirm its license, final slot and release policy. The card's control is what submits it — you hold no verb that does. Submitting is also the one action that then needs the person in Reflections: the card hands them that link itself, so never build one, and never describe the slot as taken until it answers.
render_license_draft
ChatGPTUse this to show one license draft as it will be read: its terms, what a PDF filled, what is still open with the next question to ask, and its controls. Call it after a few saves or when the person should see the draft; save_license_draft draws nothing.
render_license_picker
ChatGPTUse this when the user should visibly choose one exact Reflections license before viewing sources or taking an action. Its "Work on" control is how they choose: it opens that license's approved sources and references in the same card, tells you so, then sends "Work on {label}: license-id …". When it has not told you the assets are showing, call render_licensed_sources for that license.
render_license_start
ChatGPTUse this when the person wants to create, start, draft, write, make or issue a license, or to offer one to someone. It shows a card with both choices — a draft for a talent to sign, or a license they issue to a brand — and any draft already under way. Starting a license needs no existing license. Opening it starts nothing.
render_licensed_sources
ChatGPTUse this to show approved sources and references for one exact license. A creationProfile license uses references to anchor new images; approved contribution finals are supporting inputs only. Other licenses may use finals for edits when granted. Its select control is how the person chooses the approved image; when they have not named which — a final to change, or a reference for a new scene — this card is how you ask which they mean: its select control records their choice; do not pick one yourself. The person can also mark up to two more of these images to combine with the one they start from — contributions, and other references when they start from a reference — and "Use this asset" carries them. When the person wants to combine images this license already has, show this card; never offer render_contribution_offer for an image it lists. Pass suggestedPrompt and suggestedMoves with the exact prompt you mean to run: the card's "Use this asset" control then opens render_source_confirmation for the image they chose, with your words. Without them, that control tells you which image they chose and any they marked to combine, and you call render_source_confirmation with it and those in extraSourceIds. Pass selectedSourceId when this render already uses an approved image or the person named one: the card opens on it and marks it in use, the others available. Pass brandItems with the prompt's products and brand marks, each with the approved image that shows it, as on render_source_confirmation: the card marks those images and "Use this asset" carries them. When the person wants to add a new image rather than see these, call render_contribution_offer; this card carries the same offer control, and only the talent can approve an offer.
render_release
ChatGPTUse this whenever the user should SEE this license's finals. It always draws every final as pictures they can click through, and opens on one of them with its release state, ChatGPT provenance when applicable, certificate, and human download action. All the finals, or the last one: omit finalId and it opens on the newest. One exact final: pass its finalId. Either way the rest stay on screen, so a request for all of them is never a click away from being answered. list_finals answers about finals in data and renders nothing; it is not the tool for showing them.
render_source_confirmation
ChatGPTUse this to stage any render under one exact license, the first and every one after it: the person confirms the source and prompt here, and the card's control is what starts it. Pass the exact prompt and moves you intend to run; never ask the person to retype them. This is the card that starts from a licensed asset. If the request could mean changing a delivered candidate or starting again from a licensed asset, ask which they mean; use render_attempt only when they point at that candidate. If more than one approved image could fit and they have not named which — a final to change, or a reference for a new scene — call render_licensed_sources so its select control chooses before this. A creationProfile license requires a reference primary; contributions and the license's other approved references can ride as extras in extraSourceIds, up to two. Other licenses may use a final for an edit or a reference for a new scene. Name each product or brand mark the render adds in brandItems, with the license's approved image that shows it — a contribution or another approved reference: that image rides the render, and the card shows it so the person confirms it. When no approved image of the license shows one, do not stage this card: call render_contribution_offer with needed. A card staged with one anyway starts nothing and shows the offer in place of its start control.
render_studio_home
ChatGPTUse this to open the Reflections home: the person's licenses with their pictures, and from there each license's assets, finals and terms. ChatGPT opens it from its sidebar; opening it starts nothing.
render_studio_panel
ChatGPTUse this to open the Reflections home beside this conversation: the person's licenses with their pictures, and from there each license's assets, finals and terms. Opening it starts nothing.
render_voice_line
ChatGPTUse this when the brand wants a spoken line in the talent's licensed voice under one exact license whose terms.voiceLines lists voices: the card shows the line, the voices it may use and what the voice never says, and the card's control is what speaks it. Pass the script exactly as the brand wrote it. You hold no verb that speaks it, and you cannot hear the result.
request_license_change
ChatGPTUse this after the user has named one exact license, one exact right, preference removal, higher final cap, or Video grant, and a reason. It notifies the talent. If Reflections answers asking for confirmation, give the user the link it returns and run this again unchanged once they confirm.
retry_cleared_edit
ChatGPTUse this when talent cleared one exact held attempt and the user wants to start that unchanged request under the same exact license.
save_license_draft
ChatGPTUse this to write what the person stated into an open license draft, against the revision render_license_draft or the last save returned. It changes only the unsigned draft: nothing is sent, signed or charged. terms: brandName, campaign, brandContactEmail (a talent's own license), windowStart and windowEnd as YYYY-MM-DD, channels and territories as codes, isExclusive with exclusivityCategory, fee in dollars. release.finalDeliverables: 1-99, or null for no limit. creationProfile: natural.v2 (photo-real) or natural-stylized.v2. addInstructions: one rule each, in the person's words. sections: each answered section with its coveredAxes and resolution (none for an explicit none). brandRequest (a draft for a talent only): talentEmail, needs, conflicts or noConflicts. A refusal says what to correct.
share_watermarked_draft
ChatGPTUse this when the user explicitly asks to show one delivered watermarked candidate from one exact license in the current conversation.
start_license_draft
ChatGPTStarts a new license draft of the chosen kind. The card's choice calls it.
start_licensed_creation
ChatGPTUse this after the user has named one exact license, one approved REFERENCE, prompt, and requested moves. If they have not named which approved image — a final to change, or a reference for a new scene — ask which they mean before choosing; a source being on screen is not the answer. Reflections builds new images from that reference; the original stays private. A source approved as a final is not a reference and cannot be used here. Name each product or brand mark the scene shows in brandItems, with the license's approved image that shows it — a contribution or another approved reference; one no approved image shows, or a logo or brand name the prompt asks for with nothing riding, is refused before anything is spent. To combine other approved images the person chose, pass them in extraSourceIds. If this is refused because the named source is not an approved reference, say that source cannot anchor this render and offer the references this license already has; never tell the person to go approve something.
start_licensed_edit
ChatGPTUse this after the user has named one exact license, one approved FINAL source, prompt, and requested moves. It begins again from that final; to change a delivered candidate, use refine_licensed_edit. If they have not named which approved image — a final to change, or a reference for a new scene — ask which they mean before choosing; a source being on screen is not the answer. Name each product or brand mark the edit adds in brandItems, with the license's approved image that shows it; one no approved image shows is refused before anything is spent. Reflections checks the request and starts a new licensed edit.
start_licensed_voice_line
ChatGPTUse this when the Reflections component's Speak it is pressed: one line in one voice the license names. It produces a marked draft; only the talent's approval releases the clean line. Component-only.
stop_waiting_for_attempt
ChatGPTUse this when the user wants to stop waiting on one exact in-flight attempt under one named license. If the work has not yet reached the image provider it is cancelled outright and cannot be undone; otherwise it keeps running and only the waiting stops, and this never claims an accepted provider job was cancelled. The result says which happened. To read progress instead, use get_attempt or render_attempt.
submit_final
ChatGPTUse this after the user has named one exact license and candidate. This uses a final slot and follows the signed license's release policy. If Reflections answers asking for confirmation, give the user the link it returns and run this again unchanged once they confirm.
vault_act
ChatGPTUse this when the person presses one of the acts the Reflections component draws on their own Library files: archive, restore, delete to Recently deleted, restore from it, turn a photo or document on or off for licenses, or rename. One answer per file. Erase now and Withdraw are done on Reflections. Component-only.