Personal Workspace
في هذه الصفحة
بداية سريعة
يوفر Hypereal API الوصول إلى نماذج توليد وسائط قوية. تتطلب جميع الطلبات مصادقة Bearer بمفتاح API الخاص بك.
توليد صورة
curl -X POST https://api.hypereal.cloud/v1/images/generate \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"prompt": "a sunset over the ocean",
"model": "gemini-3-1-flash-t2i",
"mode": "fast"
}'توليد فيديو
curl -X POST https://api.hypereal.cloud/v1/videos/generate \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "wan-2-6-i2v",
"mode": "fast",
"input": {
"prompt": "a cat walking",
"image": "https://example.com/cat.jpg"
}
}'POST
/api/v1/chatجديدUp to 200k context
محادثة LLM
API محادثة LLM قوي مع دعم البث. مثالي لبناء روبوتات المحادثة وتوليد المحتوى ومساعدة البرمجة وأي تطبيق محادثة AI.
النماذج المتاحة
claude-opus-4-6
Claude Opus 4.6(Anthropic)20% OFF
Input: $4.00/MTok · Output: $20.00/MTok · Context: 200k
claude-sonnet-4-6
Claude Sonnet 4.6(Anthropic)20% OFF
Input: $2.40/MTok · Output: $12.00/MTok · Context: 200k
qwen3.5-plus
Qwen 3.5 Plus(Alibaba)40% OFF
Input: $0.60/MTok · Output: $3.60/MTok · Context: 128k
qwen3-max
Qwen3 Max(Alibaba)40% OFF
Input: $1.10/MTok · Output: $4.20/MTok · Context: 128k
qwen3.5-flash
Qwen 3.5 Flash(Alibaba)40% OFF
Input: $0.20/MTok · Output: $1.80/MTok · Context: 128k
deepseek-v3.2
DeepSeek V3.2(DeepSeek)40% OFF
Input: $0.60/MTok · Output: $2.40/MTok · Context: 128k
glm-5
GLM-5(Zhipu)40% OFF
Input: $0.60/MTok · Output: $2.70/MTok · Context: 128k
kimi-k2.5
Kimi K2.5(Moonshot)39% OFF
Input: $0.60/MTok · Output: $3.20/MTok · Context: 128k
MiniMax-M2.5
MiniMax M2.5(MiniMax)38% OFF
Input: $0.35/MTok · Output: $1.30/MTok · Context: 128k
claude-haiku-4-5
Claude Haiku 4.5(Anthropic)40% OFF
Input: $0.60/MTok · Output: $3.00/MTok · Context: 200k
gemini-2.0-flash
Gemini 2.0 Flash(Google)10% OFF
Input: $0.08/MTok · Output: $0.36/MTok · Context: 1M
gemini-2.5-flash
Gemini 2.5 Flash(Google)40% OFF
Input: $0.18/MTok · Output: $1.50/MTok · Context: 1M
gemini-2.5-pro
Gemini 2.5 Pro(Google)40% OFF
Input: $0.76/MTok · Output: $6.00/MTok · Context: 1M
gemini-3-flash
Gemini 3 Flash(Google)25% OFF
Input: $0.30/MTok · Output: $1.80/MTok · Context: 1M
gemini-3.1-fast
Gemini 3.1 Fast(Google)56% OFF
Input: $0.70/MTok · Output: $4.20/MTok · Context: 1M
gpt-5
GPT-5(OpenAI)50% OFF
Input: $0.50/MTok · Output: $4.00/MTok · Context: 128k
gpt-5.4
GPT-5.4(OpenAI)50% OFF
Input: $1.00/MTok · Output: $6.00/MTok · Context: 128k
gpt-5.4-mini
GPT-5.4 Mini(OpenAI)50% OFF
Input: $0.30/MTok · Output: $1.80/MTok · Context: 128k
gpt-5.4-nano
GPT-5.4 Nano(OpenAI)50% OFF
Input: $0.08/MTok · Output: $0.48/MTok · Context: 128k
gemini-3.1-pro
Gemini 3.1 Pro(Google)50% OFF
Input: $0.80/MTok · Output: $4.80/MTok · Context: 1M
dolphin
Dolphin (Uncensored)(Venice)
Input: $0.20/MTok · Output: $0.90/MTok · Context: 33k
جسم الطلب
model
اختياري
Model ID from the list above (default: claude-sonnet-4-6)
messages
مطلوب
Array of message objects with
role and contenttemperature
اختياري
Sampling temperature 0.0-2.0 (default: 0.8)
max_tokens
اختياري
Maximum tokens to generate (default: 4096)
stream
اختياري
Enable SSE streaming (default: true)
الأسعار
Pricing varies by model. See the model list above for per-model input/output rates. Credits scale with token usage. See full pricing.
طلب cURL
curl -X POST https://api.hypereal.cloud/v1/chat \
-H "Content-Type: application/json" \
-H "Authorization: Bearer YOUR_API_KEY" \
-d '{
"messages": [
{"role": "user", "content": "Hello, how are you?"}
],
"stream": false
}'Response (200 OK)
{
"id": "chatcmpl-abc123",
"choices": [{
"index": 0,
"message": {
"role": "assistant",
"content": "Hello! I'm doing great..."
},
"finish_reason": "stop"
}],
"creditsUsed": 2
}JavaScript (Streaming)
const response = await fetch('https://api.hypereal.cloud/v1/chat', {
method: 'POST',
headers: {
'Content-Type': 'application/json',
'Authorization': 'Bearer YOUR_API_KEY'
},
body: JSON.stringify({
messages: [{ role: 'user', content: 'Hi!' }],
stream: true
})
});
const reader = response.body.getReader();
while (true) {
const { done, value } = await reader.read();
if (done) break;
// Process SSE chunks
}POST
/api/v1/images/generateتوليد الصور
أنشئ صوراً باستخدام أحدث نماذج AI. تعالج نقطة النهاية هذه الطلبات بشكل متزامن وتُرجع عنوان URL للصورة المُولّدة مباشرة في الاستجابة.
جسم الطلب
prompt
مطلوب
Text description of the image to generate
model
اختياري
Model slug (defaults to
gemini-3-1-flash-t2i)size
اختياري
Output resolution (e.g., "1024*1024")
image
اختياري
Source image URL (for image editing models)
mode
اختياري
auto (default) or fast. Auto selects the best provider. Fast uses Wavespeed direct (no queue, surcharge applies).حقول الاستجابة
created
Unix timestamp of when the image was created
data
Array containing the generated image(s) with
url and modelcreditsUsed
Number of credits consumed for this generation
resultId
Unique identifier for the generated result
طلب cURL
curl -X POST https://api.hypereal.cloud/v1/images/generate \
-H "Content-Type: application/json" \
-H "Authorization: Bearer YOUR_API_KEY" \
-d '{
"prompt": "A futuristic cityscape at sunset with flying cars",
"model": "gemini-3-1-flash-t2i",
"mode": "fast",
"aspect_ratio": "16:9"
}'Response (200 OK)
{
"created": 1766841456,
"data": [
{
"url": "https://pub-xxx.r2.dev/generated/images/xxx.png",
"model": "gemini-3-1-flash-t2i"
}
],
"resultId": "res_abc123456",
"creditsUsed": 4
}POST
/api/v1/videos/generateتوليد الفيديوهات
أنشئ فيديوهات باستخدام أحدث نماذج AI. تدعم نقطة النهاية هذه التوليد من نص إلى فيديو ومن صورة إلى فيديو مع استدعاءات webhook للتسليم غير المتزامن.
جسم الطلب
model
مطلوب
Model slug (e.g.,
veo-3-1-i2v)input.prompt
اختياري
Text description for video generation
input.image
اختياري
Source image URL for image-to-video models
input.duration
اختياري
Video duration in seconds (model-dependent)
webhook_url
اختياري
URL to receive the result when generation completes
mode
اختياري
auto (default) or fast. Auto selects the best provider. Fast uses Wavespeed direct (no queue, surcharge applies).حقول الاستجابة
jobId
Unique job identifier for polling status
outputUrl
Generated video URL (available when complete)
creditsUsed
Number of credits consumed for this generation
طلب cURL
curl -X POST https://api.hypereal.cloud/v1/videos/generate \
-H "Content-Type: application/json" \
-H "Authorization: Bearer YOUR_API_KEY" \
-d '{
"model": "veo-3-1-i2v",
"mode": "fast",
"input": {
"prompt": "Camera slowly pans across the scene",
"image": "https://hypereal.tech/demo-girl.webp",
"duration": 5
},
"webhook_url": "https://your-server.com/webhook"
}'Response (202 Accepted)
{
"jobId": "job_abc123456",
"status": "processing",
"message": "Generation started. Result will be sent to your webhook URL.",
"creditsUsed": 69
}POST
/api/v1/audio/generateNew64+ emotions
Generate Audio
Text-to-speech, voice cloning, and speech recognition. Supports 64+ emotional expressions for natural-sounding speech synthesis.
النماذج المتاحة
minimax-voice-clone
Clone any voice from an audio sample and generate speech with that voice
minimax-speech-02
Fast text-to-speech synthesis with emotion control and multiple voice options
minimax-music-02
AI music generation with vocals from text prompts and lyrics
audio-tts
High-quality text-to-speech synthesis with natural intonation and multiple output formats
qwen3-tts-flash
Low-latency text-to-speech with 49+ expressive voices, 10 languages, and Chinese dialects. Optimized for real-time conversations.
audio-clone
Clone any voice from an audio sample and generate speech with zero-shot voice cloning
audio-asr
Automatic speech recognition to transcribe audio to text with timestamps
Emotion Syntax
Wrap emotions in parentheses at the start of text:
(happy) Hello! • (sad) I miss you • (excited)(laughing) Amazing!Text-to-Speech
curl -X POST https://api.hypereal.cloud/api/v1/audio/generate \
-H "Content-Type: application/json" \
-H "Authorization: Bearer YOUR_API_KEY" \
-d '{
"model": "audio-tts",
"input": {
"text": "(happy) Welcome to Hypereal!",
"format": "mp3"
}
}'Voice Clone
{
"model": "audio-clone",
"input": {
"text": "Clone my voice!",
"audio": "https://example.com/voice.mp3"
}
}Speech Recognition Response
{
"success": true,
"text": "Hello, welcome to Hypereal.",
"duration": 2.5,
"segments": [
{"text": "Hello,", "start": 0.0, "end": 0.8},
{"text": "welcome to Hypereal.", "start": 0.9, "end": 2.5}
]
}POST
/api/v1/3d/generateNewGLB output
Generate 3D Models
Convert images or text to 3D models using state-of-the-art AI. Generate high-quality GLB models ready for use in games, AR/VR, and web applications.
النماذج المتاحة
tripo3d-2-5-i3d
Single image to 3D (Tripo3D V2.5)
tripo3d-multiview-to-3d
4-view images to 3D (front, back, left, right)
hunyuan3d-v2-base
Single image to 3D with 4K textures (Hunyuan3D)
hunyuan3d-v2-multiview
3-view images to 3D, fast ~30s (front, back, left)
meshy6-text-to-3d
Text to 3D with GLB, FBX, OBJ, USDZ output (Meshy6)
meshy6-image-to-3d
Image to 3D with GLB, FBX, OBJ, USDZ output (Meshy6)
Output Format
All 3D models are returned in GLB format, which is widely supported by 3D viewers, game engines, and web frameworks.
Single Image to 3D
curl -X POST https://api.hypereal.cloud/api/v1/3d/generate \
-H "Content-Type: application/json" \
-H "Authorization: Bearer YOUR_API_KEY" \
-d '{
"model": "hunyuan3d-v2-base",
"input": {
"image": "https://example.com/object.png"
}
}'Multi-View to 3D
{
"model": "tripo3d-multiview-to-3d",
"input": {
"front_image_url": "https://example.com/front.png",
"back_image_url": "https://example.com/back.png",
"left_image_url": "https://example.com/left.png",
"right_image_url": "https://example.com/right.png"
}
}Response
{
"success": true,
"outputUrl": "https://cdn.hypereal.tech/3d/model.glb",
"creditsUsed": 45
}Processing Modes
Synchronous (Images)
The /api/v1/images/generate endpoint processes requests synchronously. The generated image URL is returned directly in the response.
Asynchronous (Videos)
The /api/v1/videos/generate endpoint processes requests asynchronously. Provide a webhook_url to receive results when complete, or poll the job status endpoint.
Webhook Delivery
Provide a webhook_url in your request to receive the result when generation completes. We'll POST the result directly to your server.
Webhook Payload
{
"status": "completed",
"outputUrl": "https://cdn.hypereal.tech/output/video.mp4",
"jobId": "job_abc123456",
"type": "video",
"model": "veo-3-1-i2v",
"creditsUsed": 69
}Example: Node.js Webhook Handler
app.post('/webhook/hypereal', express.json(), (req, res) => {
const { status, outputUrl, jobId, error } = req.body;
if (status === 'completed') {
console.log(`Job ${jobId} completed: ${outputUrl}`);
// Save to database, notify user, etc.
} else if (status === 'failed') {
console.error(`Job ${jobId} failed: ${error}`);
}
// Always return 200 to acknowledge receipt
res.status(200).json({ received: true });
});✓
Return 200 immediately
Process asynchronously if needed, but respond quickly to avoid timeouts.
✓
Handle idempotency
Use jobId to prevent duplicate processing.
GET
/api/v1/jobs/{id}Job Polling
If you can't receive webhooks, use the pollUrl returned in the initial response to check job status until complete.
Query Parameters
model
Model slug used for generation
type
video or imagePoll Request
GET /api/v1/jobs/job_abc123?model=veo-3-1-i2v&type=video
Response (Completed)
{
"status": "completed",
"outputUrl": "https://cdn.hypereal.tech/output/video.mp4",
"jobId": "job_abc123"
}Supported Models
All available models with their parameters and pricing.
Video Generation (39 models)
Image Generation (16 models)
Image Editing (8 models)
Audio Generation (7 models)
3D Model Generation (6 models)
Error Responses
All endpoints return standard HTTP status codes with error details in JSON format.
401
Unauthorized
{
"error": "Unauthorized. Please log in..."
}400
Bad Request
{
"error": "Model is required"
}402
Insufficient Credits
{
"error": "Insufficient credits",
"required": 69,
"available": 10
}404
Not Found
{
"error": "Job not found"
}Rate Limits
Rate limits are enforced per API key on a rolling 1-hour window.
Default Limit1000 requests/hour
Each API key has a default rate limit of 1000 requests per hour. Exceeding returns 429.
Credits
Credits are deducted when you submit a request (before processing). If the generation fails or returns no output, credits are automatically refunded to your account.
LLM Chat
New2+ credits per message
Video Generation
20-150 credits per video
Image Generation
4-25 credits per image
Image Editing
4-14 credits per edit
Audio Generation
107 credits per voice clone
3D Model Generation
45 credits per 3D model