Error Catalog And Fixes

Problem: Request body is not valid JSON.

Solution: Check JSON syntax (quotes, commas, brackets) and ensure Content-Type is application/json.

Problem: A JSON object with request fields is expected.

Solution: Send an object with model, prompt, and optional parameters.

Problem: API expects a JSON object but received another type.

Solution: Send body as a JSON object.

Problem: Selected model is not supported for this endpoint.

Solution: Use one of: nanobanano-2, nanobanano-2-2k, nanobanano-2-4k.

Problem: Prompt is missing or empty.

Solution: Provide a non-empty string in the prompt field.

Problem: urls must be an array of strings.

Solution: Use urls format like ["https://...", "data:image/png;base64,..."].

Problem: Provided aspectRatio is not supported.

Solution: Use one of: auto, 1:1, 16:9, 9:16, 4:3, 3:4, 3:2, 2:3, 5:4, 4:5, 21:9.

Problem: webHook must be a string.

Solution: Provide callback URL as string or '-1' for polling mode.

Problem: shutProgress must be boolean.

Solution: Use true or false.

Problem: id is missing or empty in result request.

Solution: Pass the id returned by generate endpoint.

Problem: Request was sent without API key credentials.

Solution: Send key via Authorization: Bearer <APISTOR_API_KEY> or x-api-key header.

Problem: Provided API key is not found, revoked, or malformed.

Solution: Verify key value or re-issue a new key in cabinet.

Problem: Account balance is lower than request price.

Solution: Top up balance or switch to a cheaper model.

Problem: Grsai API key is not configured on server.

Solution: Set GRSAI_API_KEY environment variable and restart the app.

Problem: Provider rejected credentials.

Solution: Verify upstream API key validity and Grsai permissions.

Problem: Provider temporarily limits request rate.

Solution: Add retries with backoff and reduce burst traffic.

Problem: Provider considers request parameters invalid.

Solution: Check model, prompt, aspectRatio, and required fields.

Problem: Provided task id does not exist upstream.

Solution: Check id and make sure it belongs to the right project/environment.

Problem: Prompt/input blocked by provider moderation.

Solution: Soften prompt wording and remove restricted content.

Problem: Generated output blocked by provider moderation.

Solution: Rephrase prompt and retry with safer context.

Problem: Provider failed internally while processing request.

Solution: Retry later and enable retry policy for critical workflows.

Problem: Provider did not respond within server timeout.

Solution: Increase GRSAI_TIMEOUT_MS or switch to webhook/polling mode.

Problem: Could not connect to provider.

Solution: Check network, DNS, and GRSAI_BASE_URL availability.

Problem: Provider returned unexpected status or error format.

Solution: Check response details and upstream logs, then retry if needed.