Responses

Streamoji uses standard HTTP codes. Errors return a JSON object with details.

Code	Status	Description
`200`	OK	Avatar generated. Returns binary `model/gltf-binary`.
`400`	Bad Request	Invalid JSON in options or missing required fields. Verify payload structure and required keys.
`401`	Unauthorized	Missing or expired Firebase ID token. Refresh using `user.getIdToken(true)` and retry.
`403`	Forbidden	Token is valid but the user is not allowed to access this endpoint. Check auth rules.
`404`	Not Found	Invalid URL. Confirm you are calling `https://glb.streamoji.com/api/process`.
`429`	Too Many Requests	Rate limit exceeded. Respect `Retry-After` and back off before retrying.
`500`	Internal Error	Unexpected error during GLB generation. Retry with exponential backoff; contact support if persistent.