Frequently Asked Questions

The Onysoft API is fully compatible with the OpenAI API format. The difference is that Onysoft offers models from multiple AI providers through a single API and bills in Turkish Lira.

Yes! You only need to change the base_url and api_key values. It is fully compatible with the OpenAI SDKs.

You can use models from OpenAI (GPT-6 Astra, GPT-5.6 Sol/Terra/Luna), Anthropic (Claude Fable 5.1, Opus 5, Sonnet 5, Haiku 4.5), Google (Gemini 3.8 Flash, Gemini 3.1 Pro), xAI (Grok 4.6, Grok 4.20), Meta (Muse Spark 1.3, Llama 4), DeepSeek (V4.1 Flash, V4 Pro), Qwen (Qwen3.8 Max), Mistral (Mistral Large 3) and many more providers.

You can add balance in Turkish Lira with a credit card via the Dashboard. A prepaid system is used.

Yes, a corporate e-invoice is issued for all your payments. You can access your invoices from the Dashboard.

When your balance reaches zero, API requests return a 402 (Payment Required) error. Service resumes automatically after you add balance.

/v1/chat/completions works synchronously and is for text/chat models (GPT-4, Claude, Gemini, Llama, etc.). The response returns immediately. /v1/video/generate, on the other hand, works asynchronously and is used for video, image and music generation — it first returns a task_id, then you poll the status with /v1/video/status/{task_id}.

Gemini image models (such as google/gemini-2.5-flash-image) are served by Google in the chat completions format — a base64 image is returned within the response. That is why they are called through /v1/chat/completions rather than /v1/video/generate.

i2i models (e.g. seedream/4.5-edit, ideogram/v3-edit) require a source image. You can send a public HTTP URL or a base64 data URI with the image_url parameter. If you send base64, the system automatically saves it to a temp file and converts it to a public URL.

This error usually comes from the generation service and means required parameters are missing. The system fills in the required parameters for most models automatically, but some models (seedream, gpt-image, flux-2) require special parameters. The current code fills these parameters in automatically — if you still get this error, the model may be temporarily unavailable upstream. Try another model (e.g. google/imagen4-t2i or ideogram/v3-text-to-image-quality).

Image generation: 10-30 seconds. Video generation: 30 seconds - 3 minutes (depending on the model and the length). Music generation: 30-90 seconds. Poll the status endpoint every 5-10 seconds to track progress.

The GET /v1/models endpoint returns all active models and the prices after the markup applied to you. Alternatively, you can visit the Models page in the Dashboard.

New models are added to the catalog through automatic synchronization. They typically become available within 24-48 hours of their public release.