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-4, GPT-4o), Anthropic (Claude 3.5), Google (Gemini), Meta (Llama), DeepSeek 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 and do not go through KieAI.

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 KieAI API 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 currently be malfunctioning on the KieAI side. Try another model (e.g. google/imagen4 or ideogram/v3-text-to-image always work).

Image generation: 5-30 seconds. Video generation: 30 seconds - 5 minutes (depending on the model and the length). Music generation: 30-90 seconds. Poll the status endpoint every 5 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.

When new models are released from OpenRouter and KieAI, they are synced from the Model Synchronization page in the admin panel. New models typically become active in the system within 24-48 hours after KieAI's release.