A few legacy keys that ReactVision has listed keep access for a transitional period. Every other legacy key, and every client key, is refused with 403 API_KEY_TYPE_NOT_ALLOWED.
Starts generating a GLB model and returns a pending task; poll it with the get operation until it is completed or failed.
quality
From text
From an image
Credits
Charged
quick
Yes
No
70
When the task starts
high_quality
Yes
Yes
175
When the model is stored
Send JSON, or multipart/form-data to upload the image (at most 10 MB). In a multipart body quality defaults to high_quality and type to text. A high_quality model has about 200,000 triangles and a 2048 px texture.
Without app_user_id the model goes into the team library, and with scene_id it is also placed in that scene. With app_user_id and project_id it is stored as a file of that project for that app user, which is deleted 90 days after it is created. The model counts against the storage quota.
A key bound to one project must send project_id (its own project) and app_user_id: its output is stored in that project for the app user, never in the team library, so scene_id placement is not available to a bound key. Without them it gets 403 ACCESS_DENIED.
Not counted against the monthly API request quota.
Recent Requests
Log in to see full request history
Time
Status
User Agent
Retrieving recent requests…
Loading…
Responses
401
MISSING_AUTH: no x-api-key header, and no other credential.
INVALID_API_KEY_FORMAT: the key is not rv_live_, rv_client_ or rv_secret_ followed by 64 lowercase hexadecimal characters.
INVALID_API_KEY: no such key, or a key sent with the wrong prefix for its type.
API_KEY_EXPIRED: the key is past its expiry date.
AUTH_ERROR: a user token (rv_ut_) was sent as a Bearer token. This operation does not accept user tokens.
403
API_KEY_TYPE_NOT_ALLOWED: a client key, or a legacy key that is not on ReactVision's transitional list.
ACCESS_DENIED: a bound key sent neither project_id nor scene_id.
SCENE_ACCESS_DENIED: scene_id is a scene the key cannot reach.
PROJECT_ACCESS_DENIED: project_id does not exist or the key cannot reach it.
LIMIT_REACHED: the generation would exceed the team's monthly AI credit budget, or the budget could not be read.
STORAGE_LIMIT_REACHED: the team is over its storage quota, or the quota could not be read.
429
RATE_LIMITED: for a secret key, more than 1,200 requests a minute across all operations. Wait the number of seconds in Retry-After. See Limits.
500
UPLOAD_FAILED: the image could not be stored.
CREATE_FAILED: the task could not be recorded.
INTERNAL_ERROR: an unexpected error. Retry, and quote meta.request_id to support if it persists.
502
SERVICE_ERROR: the provider did not start the generation. Nothing is charged.
503
API_KEY_LOOKUP_FAILED: the key could not be checked. Retry; this does not mean the key is invalid.
SERVICE_NOT_CONFIGURED: this quality is unavailable.