Paid: text→3D / image→3D generation (returns a job token)

Pay per quality tier in USDC ($0.05 draft / $0.15 standard / $0.50 high) to generate a 3D model. Submit a prompt for text→3D, or up to four public https reference views of one object for image→3D. Runs the FLUX→TRELLIS pipeline. The response returns a job token; poll it for FREE at GET /api/forge?job=<id> to retrieve the finished GLB URL. The 402 challenge quotes the exact price for the requested tier.

post/api/x402/forge

Request

  • Base URL: https://three.ws
  • URL: https://three.ws/api/x402/forge
  • Auth: none required

Request body

promptstring

Describe one subject for text→3D. Omit when supplying image_urls.

image_urlsstring[]

Up to six public https reference views of one object for image→3D.

tier'draft' | 'standard' | 'high'
aspect_ratio'1:1' | '4:3' | '3:4' | '16:9' | '9:16'

Response

Generation job accepted; poll poll_url for the GLB

job_idstring required
statusstring required
poll_urlstring required

Free, provider-aware status endpoint.

mode'text_to_3d' | 'image_to_3d'
tierstring
backendstring
eta_secondsinteger
price_usdcstring

Changes

No recorded changes to this operation across all 1 revision of this API.