Inference Quick Start

Get up and running with Hyperbolic’s Serverless Inference API in minutes. This guide walks you through making your first API calls for text, image, and audio generation.

Prerequisites

Hyperbolic Account

API Key

Generate your API key

Python or cURL

Python 3.7+ or cURL installed

Get Your API Key

Log into the Dashboard

Go to app.hyperbolic.ai and sign in to your account.

Navigate to API Keys

Click on Settings in the sidebar, then select API Keys.

Create a New Key

Click Create API Key and copy the generated key.

Keep your API key secure. Never expose it in client-side code or public repositories.

Text Generation

Generate text using large language models with the chat completions endpoint.

Python
cURL

import requests

url = "https://api.hyperbolic.xyz/v1/chat/completions"
headers = {
    "Content-Type": "application/json",
    "Authorization": "Bearer YOUR_API_KEY"
}
data = {
    "messages": [
        {"role": "user", "content": "What are three tips for learning to code?"}
    ],
    "model": "deepseek-ai/DeepSeek-V3",
    "max_tokens": 512,
    "temperature": 0.7
}

response = requests.post(url, headers=headers, json=data)
print(response.json()["choices"][0]["message"]["content"])

curl -X POST "https://api.hyperbolic.xyz/v1/chat/completions" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
    "messages": [
      {"role": "user", "content": "What are three tips for learning to code?"}
    ],
    "model": "deepseek-ai/DeepSeek-V3",
    "max_tokens": 512,
    "temperature": 0.7
  }'

The chat completions endpoint is OpenAI-compatible. You can use the OpenAI Python SDK by setting the base URL to https://api.hyperbolic.xyz/v1.

Image Generation

Generate images from text prompts using state-of-the-art diffusion models.

Python
cURL

import requests
import base64

url = "https://api.hyperbolic.xyz/v1/image/generation"
headers = {
    "Content-Type": "application/json",
    "Authorization": "Bearer YOUR_API_KEY"
}
data = {
    "model_name": "FLUX.1-dev",
    "prompt": "A futuristic city skyline at sunset, cyberpunk style",
    "steps": 30,
    "cfg_scale": 5,
    "height": 1024,
    "width": 1024
}

response = requests.post(url, headers=headers, json=data)
result = response.json()

# Save the generated image
image_data = base64.b64decode(result["images"][0]["image"])
with open("generated_image.png", "wb") as f:
    f.write(image_data)

curl -X POST "https://api.hyperbolic.xyz/v1/image/generation" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
    "model_name": "FLUX.1-dev",
    "prompt": "A futuristic city skyline at sunset, cyberpunk style",
    "steps": 30,
    "cfg_scale": 5,
    "height": 1024,
    "width": 1024
  }'

Sunset Notice: FLUX.1-dev and all other image generation models are being discontinued. Please plan your migration accordingly.

The response contains a base64-encoded image in the images array. Decode it to save or display the generated image.

Audio Generation

Convert text to natural-sounding speech using the audio generation endpoint.

Python
cURL

import requests
import base64

url = "https://api.hyperbolic.xyz/v1/audio/generation"
headers = {
    "Content-Type": "application/json",
    "Authorization": "Bearer YOUR_API_KEY"
}
data = {
    "text": "Welcome to Hyperbolic! This is an example of text-to-speech generation.",
    "speed": 1
}

response = requests.post(url, headers=headers, json=data)
result = response.json()

# Save the generated audio
audio_data = base64.b64decode(result["audio"])
with open("generated_audio.mp3", "wb") as f:
    f.write(audio_data)

curl -X POST "https://api.hyperbolic.xyz/v1/audio/generation" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
    "text": "Welcome to Hyperbolic! This is an example of text-to-speech generation.",
    "speed": 1
  }'

The speed parameter controls playback speed (1.0 is normal). The response contains base64-encoded audio data.

Next Steps

Text APIs

Explore chat completions and more

Image APIs

Learn about image generation

Audio APIs

Dive into text-to-speech

Overview

GPUs

References

Account & Billing

Quick Start

Inference Quick Start

Prerequisites

Hyperbolic Account

API Key

Python or cURL

Get Your API Key

Text Generation

Image Generation

Audio Generation

Next Steps

Text APIs

Image APIs

Audio APIs

​Inference Quick Start

​Prerequisites

Hyperbolic Account

API Key

Python or cURL

​Get Your API Key

​Text Generation

​Image Generation

​Audio Generation

​Next Steps

Text APIs

Image APIs

Audio APIs

Inference Quick Start

Prerequisites

Get Your API Key

Text Generation

Image Generation

Audio Generation

Next Steps