M3D
ModelAI3D
Developer Documentation

Dokumentacja API ModelAI3D

Kompletny przewodnik po API ModelAI3D - od quick start do zaawansowanych integracji. RESTful API z bibliotekami SDK dla JavaScript, Python i innych języków.

Quick Start

Rozpocznij w 5 minut - uzyskaj API key i wyślij pierwsze zapytanie

1Uzyskaj API Key

Zarejestruj się w panelu developerskim i wygeneruj swój unikalny API key. Darmowy tier oferuje 1000 requestów miesięcznie.

Przejdź do panelu developerskiego

2Wybierz SDK lub użyj REST

Zainstaluj oficjalny SDK dla swojego języka lub używaj bezpośrednio REST API z dokumentacją OpenAPI.

npm install @modelai3d/sdk
pip install modelai3d

3Wyślij pierwsze zapytanie

Użyj text-to-3D endpoint aby wygenerować swój pierwszy model. Response zawiera URL do pobrania pliku GLB.

JavaScript / Node.js
import { ModelAI3D } from '@modelai3d/sdk'

const client = new ModelAI3D({
  apiKey: process.env.MODELAI3D_API_KEY
})

const result = await client.generate({
  prompt: "Nowoczesne krzesło biurowe",
  format: "glb",
  quality: "high"
})

console.log(result.modelUrl)
// https://cdn.modelai3d.net/abc123.glb
Python
from modelai3d import Client

client = Client(api_key="your_api_key")

result = client.generate(
  prompt="Nowoczesne krzesło biurowe",
  format="glb",
  quality="high"
)

print(result.model_url)
# https://cdn.modelai3d.net/abc123.glb

API Reference

Pełna dokumentacja wszystkich endpoints i parametrów

POST/v1/generate

Text-to-3D Generation

Generuj model 3D z promptu tekstowego

Parametry:

prompt(string) *required - Opis modelu do wygenerowania
format(string) - Format wyjściowy: glb, fbx, obj (default: glb)
quality(string) - Jakość: low, medium, high (default: medium)
texture_resolution(number) - Rozdzielczość tekstur: 1024, 2048, 4096 (default: 2048)
POST/v1/generate/image

Image-to-3D Reconstruction

Generuj model 3D z obrazu lub zdjęcia

Parametry:

image_url(string) *required - URL obrazu źródłowego
depth_estimation(boolean) - Włącz automatic depth estimation (default: true)
format(string) - Format wyjściowy: glb, fbx, obj (default: glb)
GET/v1/models/:id

Get Model Status

Sprawdź status generowania modelu

Parametry:

id(string) *required - ID modelu zwrócone przez /generate
POST/v1/models/:id/variations

Generate Variations

Generuj wariacje istniejącego modelu

Parametry:

id(string) *required - ID modelu bazowego
count(number) - Liczba wariacji (1-10, default: 3)
variation_strength(number) - Siła wariacji 0-1 (default: 0.5)

Funkcje dla deweloperów

Webhooks

Otrzymuj real-time notyfikacje o statusie generowania. Konfiguruj webhook URLs w panelu developerskim.

  • ✓Event-driven architecture
  • ✓Retry mechanism
  • ✓Signature verification

Authentication

Bezpieczna autentykacja API key w header. Support dla OAuth 2.0 dla aplikacji enterprise.

  • ✓API key rotation
  • ✓IP whitelisting
  • ✓Scoped permissions

Rate Limits

Fair usage policy z generous limits. Free tier: 1000 req/mo, Pro: 50k req/mo, Enterprise: unlimited.

  • ✓Per-endpoint limits
  • ✓Burst allowance
  • ✓Rate limit headers

OpenAPI Spec

Pełna specyfikacja OpenAPI 3.0 dla automatycznego generowania klientów i dokumentacji.

  • ✓Auto-generated clients
  • ✓Swagger UI
  • ✓Postman collection

CLI Tool

Narzędzie command-line dla szybkiego prototypowania i batch processing z terminala.

  • ✓Batch operations
  • ✓Interactive mode
  • ✓CI/CD integration

SDKs

Oficjalne biblioteki dla JavaScript, Python, Go, PHP, Ruby. Community SDKs dla innych języków.

  • ✓Type-safe
  • ✓Promise-based
  • ✓Fully documented

Potrzebujesz pomocy z integracją?

Nasz zespół developerów pomoże Ci w każdym aspekcie integracji API

Developer Community

Dołącz do społeczności developerów na Discord i GitHub Discussions

DiscordGitHub

Technical Support

Enterprise support z dedykowanym technical account manager

Skontaktuj się

Gotowy na integrację?

Zarejestruj się teraz i otrzymaj darmowy API key z 1000 requestów miesięcznie

Zarejestruj się za darmoZobacz pricing