Skip to main content
POST
Create an asset generation

Authorizations

Authorization
string
header
required

Your API key, as a Bearer token: Authorization: Bearer <key>.

Headers

Idempotency-Key
string | null

A client-generated key that dedupes retries of this exact request.

Body

Request body for POST /assets.

input
GenerationInput · object
required

The generation input describing the 3D model to build.

config
GenerationConfig · object

Generation settings. Omit to accept the defaults.

project_id
string | null

Attach this generation to an existing project you own (from a previous generation's project_id) so related assets live together. Omit to create a fresh project for the generation.

mode
enum<string>
default:quote

generate runs the generation and spends credits. The default quote only prices the request: nothing is generated and no credits are charged.

Available options:
quote,
generate

Response

mode was quote (the default): a price quote, with nothing generated and no credits charged.

A price quote for a would-be generation: the request's assessed complexity, the effort applied, and the credit price for that pair. Nothing is generated or charged.

message
string
required

Human-readable confirmation that nothing was generated, and how to submit the generation for real.

model_version
enum<string>
required

The model_version this quote priced (echoed from the request config).

Available options:
standard,
lite
complexity
enum<string> | null
required

Inferred complexity: simple, moderate, or complex. null for model_version: lite, which isn't scored.

Available options:
simple,
moderate,
complex
effort
enum<string>
required

The effort this quote priced (echoed from the request config).

Available options:
low,
high,
max
credits
integer
required

Credits this generation would cost: effort × complexity for standard, a flat rate for lite.