API Reference
Get Started

API Reference

REST API v1

Integrate Wubble's AI audio generation into your applications with our comprehensive REST API

Overview

The Wubble API provides programmatic access to AI audio generation capabilities. Generate music, speech, and sound effects through simple HTTP requests, then track request status, usage, and webhook deliveries from the same developer surface.

Built for developers, our RESTful API is designed with simplicity, reliability, and performance in mind. Whether you're building a content creation platform, a game audio system, or an automated video production pipeline, Wubble API scales with your needs.

What You Can Build

Automated video production with custom soundtracks
Podcast tools with AI-generated intros and outros
Game audio systems with dynamic music and SFX
Content creation platforms with audio intelligence
Marketing automation with branded audio
Voice-enabled applications and assistants
Base URL: https://prod-backup-backend.wubble.ai/v1

Key Features

Music Generation

Generate original music from text descriptions. Control style, mood, tempo, and instrumentation with natural language.

Text-to-music generation
Extend and remix tracks
Stem separation
Style transfer

Voice Generation

Generate natural-sounding speech from text. Choose from voices or clone custom voices for your brand.

Text-to-speech (TTS)
Voice cloning
Emotion and emphasis control
Multi-language support

Sound Effects

Generate custom sound effects for games, videos, and interactive experiences from simple descriptions.

Text-to-SFX generation
Variations and layering
Game-ready formats
Category-based generation

Usage & Webhooks

Inspect request usage, monitor limits, and react to completed jobs with webhook events and dashboard telemetry.

Usage and balance reads
Webhook registrations
Async completion polling
Billing and allowance visibility

Quick Start

Get started with the Wubble API in three simple steps:

1

Get Your API Key

Generate an API key from your API Keys dashboard. Keep it secure and never commit it to version control.

2

Make your first API call

Use standard HTTP clients directly against /v1 endpoints (for example fetch, requests, or curl).

GET/v1/credits
Auth: API keyBilling: FreeBehavior: Compatibility balance check
Make your first API call
const API_BASE_URL = "https://prod-backup-backend.wubble.ai";
const API_KEY = process.env.WUBBLE_API_KEY ?? "wbk_your_api_key";

const response = await fetch(`${API_BASE_URL}/v1/credits`, {
  headers: { Authorization: `Bearer ${API_KEY}` },
});

if (!response.ok) throw new Error(`HTTP ${response.status}`);

const { success, data, error } = await response.json();
if (!success) throw new Error(error?.message ?? "Request failed");

console.log("API calls remaining:", data.api_calls_remaining);
3

Try more endpoints

Use the API playground for a quick glance at core calls, then jump into the endpoint reference for full route coverage.

Using cURL

You can also interact with the API directly using cURL or any HTTP client:

cURL Examplebash
# Check API call allowance (GET) — swap in your real API key
curl -s https://prod-backup-backend.wubble.ai/v1/credits \
  -H "Authorization: Bearer YOUR_API_KEY"

API Principles

The Wubble API is designed with the following principles to ensure a great developer experience:

RESTful Design

Predictable route families with standard HTTP methods such as GET, POST, and DELETE

JSON First, Multipart Where Needed

Most routes use JSON, with multipart uploads for speech files and music source uploads

Secure by Default

HTTPS only, API key authentication, and comprehensive security best practices

Fast and Reliable

Async request polling, webhook delivery, and CDN-backed output URLs for completed artifacts

Comprehensive Monitoring

Real-time usage analytics, detailed error messages, and debugging tools

Versioned

API versioning ensures backward compatibility and smooth upgrades

Pricing and usage at a glance

Included monthly allowance
  • Free: 5 API calls
  • Basic: 10 API calls
  • Business: 50 API calls
Dedicated API plans
  • API Starter: SGD 29 / month for 150 calls
  • API Business: SGD 99 / month for 700 calls
  • Each billable generation request consumes 1 API call

Error Handling

The API uses standard HTTP status codes and returns detailed error messages in JSON format to help you debug issues quickly:

Error Response Formatjson
{
  "error": {
    "code": "invalid_request",
    "message": "The 'prompt' parameter is required",
    "details": {
      "param": "prompt",
      "type": "missing_required_field"
    }
  }
}

Common Status Codes

Status CodeMeaningWhen to Expect
200 OKRequest successfulNormal operation
201 CreatedResource createdPOST requests
400 Bad RequestInvalid parametersValidation errors
401 UnauthorizedInvalid API keyAuthentication failure
403 ForbiddenInsufficient permissionsQuota exceeded or scope limited
429 Too Many RequestsRate limit exceededToo many requests
500 Internal Server ErrorServer errorSomething went wrong on our end

Next Steps

Explore the documentation to learn more about authentication, endpoints, and best practices:

Need Help?

If you have questions about the API, reach out to our developer support team at support@wubble.ai or join our developer community on Discord.

Was this page helpful?