micro/go-micro · error

API error (%s): %s

Error message

API error (%s): %s

What it means

GenerateImage throws this when the submit response arrives with a non-200 HTTP status. It embeds the HTTP status line and the raw response body so the caller can see exactly what the AtlasCloud API rejected. Unlike the chat path, there is no retry/RateLimit handling here — the error is returned immediately.

Source

Thrown at ai/atlascloud/atlascloud.go:964

	}

	apiURL := strings.TrimRight(p.opts.BaseURL, "/") + "/api/v1/model/generateImage"
	httpReq, err := http.NewRequestWithContext(ctx, http.MethodPost, apiURL, bytes.NewReader(reqBody))
	if err != nil {
		return nil, fmt.Errorf("failed to create request: %w", err)
	}
	httpReq.Header.Set("Content-Type", "application/json")
	httpReq.Header.Set("Authorization", "Bearer "+p.opts.APIKey)

	httpResp, err := http.DefaultClient.Do(httpReq)
	if err != nil {
		return nil, fmt.Errorf("API request failed: %w", err)
	}
	defer httpResp.Body.Close()

	respBody, _ := io.ReadAll(httpResp.Body)
	if httpResp.StatusCode != http.StatusOK {
		return nil, fmt.Errorf("API error (%s): %s", httpResp.Status, string(respBody))
	}

	var submitResp struct {
		Code int    `json:"code"`
		Msg  string `json:"message"`
		Data struct {
			ID     string `json:"id"`
			Status string `json:"status"`
		} `json:"data"`
	}
	if err := json.Unmarshal(respBody, &submitResp); err != nil {
		return nil, fmt.Errorf("failed to parse submit response: %w", err)
	}
	if submitResp.Code != 200 {
		return nil, fmt.Errorf("API error: %s", submitResp.Msg)
	}

	predictionID := submitResp.Data.ID

View on GitHub (pinned to 24529f1404)

Solutions

1. Read the embedded body in the error — it contains the API's JSON error message identifying the cause.
2. For 401/403, verify and rotate the API key (Authorization: Bearer p.opts.APIKey).
3. For 429, back off and retry later; check your AtlasCloud quota/plan.
4. For 404, confirm BaseURL and that the /api/v1/model/generateImage path exists for your API version.

if apiKey == "" {
    return fmt.Errorf("ATLASCLOUD_API_KEY is not set")
}

img, err := provider.GenerateImage(ctx, req)
if err != nil {
    var apiErr *AIError // or match on "API error ("
    if strings.Contains(err.Error(), "API error (401") || strings.Contains(err.Error(), "API error (403") {
        return fmt.Errorf("check AtlasCloud API key: %w", err)
    }
    if strings.Contains(err.Error(), "API error (429") {
        // backoff and retry later
    }
    return err
}

When it happens

Trigger: httpResp.StatusCode != http.StatusOK on the generateImage submit call: 401 (bad API key), 403, 404 (wrong path/BaseURL), 429 (rate limited), or 5xx from the provider.

Common situations: Expired or missing ATLASCLOUD API key, wrong BaseURL pointing at a non-image endpoint, exceeding image-generation quotas, or provider outage returning 502/503 through a load balancer.

Related errors

• ErrInvalidToken
• API request failed: %w
• failed to parse response: %w
• no response from API
• failed to parse submit response: %w

AI-assisted analysis of micro/go-micro@24529f1404 (2026-09-01). Data as JSON: /api/errors/7ecb8973374d785b. Report an issue: GitHub.