Frequently Asked Questions

3D AI Studio

Frequently Asked Questions

Common questions about the 3D AI Studio API, pricing, formats, and integration.

What is the 3D AI Studio API?

The 3D AI Studio API is a REST API that lets you generate 3D models from text or images, generate and edit images with AI, process 3D files with tools like format conversion and mesh repair, and create miniature figurines from photos. It is designed for developers building applications in gaming, e-commerce, AR/VR, architecture, 3D printing, and creative industries.

How much does the API cost?

The API uses a credit based system. You purchase credits through the dashboard and each request costs a specific number of credits. For example, 3D model generation costs 35 to 100 credits depending on the edition and options, image generation costs 50 to 80 credits per image depending on resolution, and tools like format conversion cost as low as 5 to 10 credits. There are no monthly fees or subscriptions required. You only pay for what you use.

What 3D file formats are supported?

The API supports GLB, glTF, OBJ, STL, PLY, FBX, and ZIP archives as both input and output for most tools. For generation endpoints, output is typically GLB. You can convert between any supported format using the Format Conversion tool. For OBJ and FBX, ZIP variants are available that bundle textures alongside the model file.

Can I generate 3D models from text descriptions?

Yes. The text to 3D endpoint accepts a text prompt (up to 1024 characters) and generates a 3D model. You can control quality settings, polygon count, PBR textures, and generation type. Both a higher quality edition and a faster edition are available.

Can I generate 3D models from images?

Yes. The image to 3D endpoint accepts a base64 encoded image and generates a 3D model from it. For the Pro edition, you can also provide multiple reference images from different angles (multi-view input) for more accurate results. PNG and JPEG images are recommended.

How long does 3D model generation take?

Generation times depend on the edition and parameters. The fast edition typically completes in 1 to 2 minutes. The default (higher quality) edition takes 3 to 5 minutes. Image generation completes in 10 to 30 seconds. Tools like format conversion and optimization usually finish within 30 seconds.

Are the generated 3D models ready for 3D printing?

Generated models can be prepared for 3D printing using the Mesh Repair tool. It automatically fixes common mesh issues, produces a watertight mesh, and can optionally hollow the model to reduce material costs. You can also scale to a target height and export in STL format with millimeter units, which is the standard for most 3D printers.

Can I use the API with Unity, Unreal Engine, or Blender?

Yes. The API outputs standard 3D formats (GLB, FBX, OBJ) that are directly compatible with Unity, Unreal Engine, Blender, and other 3D software. GLB is recommended for Unity and web applications. FBX works well with Unreal Engine. You can use the Format Conversion tool to convert to whichever format your engine requires.

Is the API suitable for e-commerce product visualization?

Yes. You can use the 3D Generation endpoints to create 3D models of products from photos, the Render tool to generate product images from multiple angles with studio lighting, and the Optimize tool to compress models for fast loading on web and mobile. The API supports transparent backgrounds and custom lighting for professional product shots.

How does authentication work?

You authenticate by including your API key in the Authorization header as a Bearer token. API keys can be created and managed from the API dashboard. Each key can be given a name, has an expiration date, and can be revoked at any time. Two factor authentication (TOTP) is required to access the dashboard.

Is there a rate limit?

Yes, the default rate limit is 3 requests per minute. If you exceed this limit, you will receive a 429 status code with the error code "rate_limited". If you need a higher rate limit, you can configure it through the dashboard settings.

How do I check the status of a generation request?

All generation requests are asynchronous. When you submit a request, you receive a task_id in the response. Poll the status endpoint (GET /v1/generation-request/<task_id>/status/) until the status field changes to "FINISHED". We recommend polling every 3 to 5 seconds. The response includes a progress field (0 to 100) so you can show progress to your users.

How long are generated results available for download?

Results are available for download for 24 hours after generation completes. After that, the status endpoint returns a 410 Gone error. Make sure to download and store your assets promptly after generation finishes.

What happens if a generation request fails?

If a generation request fails, the status will show "FAILED" and your credits are automatically refunded to your wallet. You do not need to take any action to receive the refund. You can check your credit balance at any time through the wallet endpoint.

Do credits expire?

Purchased credits expire after 365 days. Your current balance, which only counts non-expired credits, is always available through the wallet endpoint. Each endpoint documentation page lists the exact credit cost for that operation so you can plan your usage.

Can I use the generated assets commercially?

Yes. All assets generated through the 3D AI Studio API can be used for commercial purposes including games, apps, e-commerce, advertising, and physical products like 3D prints. You retain full rights to the output generated from your inputs.

Is my data secure?

Yes. Uploaded images and generated assets are stored securely and are only accessible to your account. API keys are hashed and never stored in plain text. The dashboard requires two factor authentication for access. Generated results are automatically deleted after 24 hours.

What programming languages can I use with the API?

The API is a standard REST API that works with any programming language or HTTP client. You can use Python, JavaScript, TypeScript, C#, Java, Go, Ruby, PHP, Swift, or any other language that can make HTTP requests. No SDK is required, just send HTTP requests with your API key in the Authorization header.

Can I process multiple requests at the same time?

Yes. You can submit multiple generation requests concurrently. Each request runs independently and can be polled separately using its task_id. Keep in mind that the rate limit still applies, so consider requesting a higher rate limit through the dashboard if you need high volume throughput.

Do you support webhooks?

Currently, results must be retrieved by polling the status endpoint. Webhook support for receiving notifications when generation completes is on our roadmap. In the meantime, we recommend polling every 3 to 5 seconds for the best balance of responsiveness and efficiency.