Skip to main content

​
Saved references first

Use authorized Studio references whenever possible. reference_image_preview returns verified saved image content; the caller does not supply an arbitrary image URL for the server to fetch. Large originals can return resized previews with separate original and preview hashes.

​
New attachments

Original PNG, JPEG and WebP references are currently limited to 3 MiB by the upload contracts. Supply an accurate source/usage declaration for the chosen Storyworld. A declaration recorded by an agent is not a separate human rights review. A supported host adapter prepares a destination and operation, verifies the original file’s MIME type, size and hash, and transfers the bytes outside model context. Use the authoritative upload receipt before creating an asset. Where this handoff is unavailable, upload through Studio’s authenticated UI and ask the agent to reuse the saved reference. Do not ask the model to reconstruct attachment bytes, invent a base64 file, fetch an arbitrary caller URL, reveal a masked upload capability or reuse another client’s OAuth credentials.

​
Images, audio and video

  • Display and inspect the actual image before describing it as agent-reviewed.
  • Use supported media previews or the returned Studio viewer for audio and video.
  • A delivered video, inspected stills, full-motion inspection and heard sound are different evidence. Report what was actually reviewed.
  • Byte-range media tools are intended for a programmatic file adapter, not base64 copied into chat.
  • The current Character speaking preview uses provider-native sound; its voice is separate from the saved ElevenLabs audition.

​
After an interrupted write

Keep the original operation ID and identical inputs. Read current workflow or job state and recover the original request. Do not automatically request replacement generation because the client timed out or lost a response. Some writes require a current document version, reference revision, candidate fingerprint or Production version. Read those values from the latest authoritative receipt. If the input changes, use the documented new-operation path rather than replaying an old operation with different content.

​
After an uncertain upload

Read the original upload status and saved receipt. Preserve a dispatch whose outcome is unknown. Do not clear a local dispatch record, rearm the file or issue another upload simply to obtain a cleaner response. Deduplication may reuse an existing Media record with the same bytes. A successful receipt must still match the intended Storyworld, original hash, MIME type and source declaration. A local “sent” result alone is not the saved Studio receipt.

​
Useful troubleshooting details

Send support the client name/version, affected step, approximate time and a non-sensitive error description. Keep tokens, upload capabilities and private creative material out of support messages. Contact support.