For developers and creators looking to integrate Buu AI directly into their apps, tools, or backend systems, the GraphQL API offers a powerful way to automate and scale 3D generation. With just a few lines of code, you can submit prompts, retrieve assets, and manage your usage — all through secure API calls.

In this guide, we’ll walk through how to access your API key, structure GraphQL requests, and make your first successful 3D generation call.

🔑 Step 1: Get Your API Key

Log in to your Buu AI account
Go to API Keys
Click Generate API Key
Copy the key and store it securely

⚠️ Treat your API key like a password, anyone with this key can use your credits.

🧠 What You Can Do with the GraphQL API

The Buu AI GraphQL endpoint allows you to:

Submit text or image prompts
Specify generation styles
Monitor credit usage
Fetch generation results, including download links and metadata

This makes it ideal for:

Creating automated pipelines
Building custom prompt interfaces
Embedding Buu AI inside your apps, bots, or services

📡 Endpoint Information

GraphQL API Base URL:
https://api.buu.ai/graphql

Standard headers:

Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

🧪 Example Query

Here’s a basic mutation that submits a prompt:

mutation {
  generate3DAsset(input: {
    prompt: "Magic staff with glowing blue crystal",
    style: "fantasy"
  }) {
    id
    status
    previewUrl
    modelUrl
  }
}

Once processed, you can use the returned id to check status or download the final model file.

🧰 Checking Generation Status

To check the status of a generation:

query {
  assetStatus(id: "asset_id_here") {
    status
    modelUrl
    previewUrl
    style
  }
}

Statuses include:

pending
processing
complete
failed

📦 Output Format

Models are returned in standard formats:

.glb is currently supported, .fbx and .obj is coming soon.
Preview images and metadata.

Download links expire after a short period, so make sure to store results promptly.

📘 Coming Soon: RESTful API

We’re currently working on a RESTful API for users who prefer traditional REST endpoints over GraphQL. Full documentation, SDKs, and Postman collections will be released in the upcoming developer update.

🧠 Pro Tips

Create a separate API key for each environment (dev, staging, prod)
Use rate limiting in your app logic
Log all requests to monitor credit usage and debug errors
Wrap API calls inside retry logic for reliability

With the GraphQL API, Buu AI becomes part of your stack, ready to generate assets at scale, on demand, and in sync with your systems.

How to Use GraphQL API Keys with Buu AI