Errors and limits

Every immediate non-2xx response uses:

type PartnerApiError = {
  code: string;
  message: string;
  requestId: string;
  retryable: boolean;
};

Stable HTTP errors

HTTP	Code	Automatic retry?
400	invalid_request	No
401	unauthorized	No
403	forbidden	No
404	not_found	No
409	scene_version_conflict	No
409	scene_operation_in_progress	No—require a current-state user decision
409	idempotency_conflict	No
409	idempotency_expired	No
409	external_ref_conflict	No
413	payload_too_large	No
415	unsupported_media	No
422	unsupported_aspect_ratio	No
429	rate_limited	Under the bounded retry recipe
503	service_unavailable	Under the bounded retry recipe

Use requestId when contacting Smore support. Do not infer internal provider or model details from a safe error.

Input limits

Input	Limit
Multipart request	21 MiB
Image file	20 MiB
Image dimensions	6144 pixels per side; 24 megapixels
Scene source	At least 1280×720 and within 1% of 16:9
Prompt or edit message	1–4000 UTF-8 characters
externalRef	1–200 characters when present
Partner name	1–80 characters
Help text	At most 240 characters or null
Accent color	Six-digit hexadecimal color
Session lifetime	300–86,400 seconds

Studio container minimums

Mode	Minimum
perform	640×360
edit	960×600
edit_and_perform	960×600