question: /v1/images/edits returns 502 no results error

[PonDevelopers]

问题内容

Bug: /v1/images/edits fails with "Image edit returned no results"

Problem:
While /v1/chat/completions and /v1/images/generations work perfectly, the /v1/images/edits endpoint consistently returns a 502 Upstream Error.

Error Log:

• upload.py:267 - Upload success: file.png -> 8d7af92d-691a-45b2-a7f2-2c907085e9a4
• exceptions.py:123 - AppException: server_error - Image edit returned no results
• response_middleware.py:75 - Response: POST /v1/images/edits - 502 (10881.28ms)

Details:

1. The image is uploaded successfully to Grok (as seen in logs).
2. FlareSolverr is active and cf_clearance is valid.
3. NSFW Mode and Thinking are both enabled.
4. I have tried multiple different images and prompts (e.g., "Transform to anime style"), but it always fails to return the edited image.

Request:
Please check if the model=grok-imagine-1.0-edit logic or the response parsing for image editing needs an update.

部署方式

本地 uv run

相关配置（请脱敏）

相关日志

Follow the description above

[PonDevelopers]

Image Edit API Returns 502 Error - Model Configuration Issue

Problem Description

The /v1/images/edits endpoint returns a 502 Bad Gateway error when attempting to edit images, even though the file upload succeeds and the request is properly formatted.

Error Logs

2026-04-01 19:05:51 | INFO     | upload.py:267 - Upload success: file.png -> 58355edb-ee85-4fae-8259-60728a1f584f
2026-04-01 19:05:52 | INFO     | chat.py:292 - Chat connected: model=grok-4, stream=True
2026-04-01 19:06:02 | WARNING  | exceptions.py:123 - AppException: server_error - Image edit returned no results
2026-04-01 19:06:02 | ERROR    | response_middleware.py:75 - Response: POST /v1/images/edits - 502 (12109.45ms)

Root Cause

The issue is in app/services/grok/services/image_edit.py at lines 38-39:

_EDIT_UPSTREAM_MODEL = "grok-4"
_EDIT_UPSTREAM_MODE = "MODEL_MODE_AUTO"

The image edit service is using the wrong upstream model. According to Grok's official API, image editing uses the imagine-image-edit model, not grok-4. This causes the Grok backend to fail silently and return no image results, which then triggers the "Image edit returned no results" exception at line 245-247.

Solution

Change the model constant in app/services/grok/services/image_edit.py (lines 38-39):

Before:

_EDIT_UPSTREAM_MODEL = "grok-4"
_EDIT_UPSTREAM_MODE = "MODEL_MODE_AUTO"

After:

_EDIT_UPSTREAM_MODEL = "imagine-image-edit"
_EDIT_UPSTREAM_MODE = "MODEL_MODE_AUTO"

Test Case

curl http://localhost:8000/v1/images/edits \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -F "model=grok-imagine-1.0-edit" \
  -F "prompt=make image clearer" \
  -F "image=@image.png" \
  -F "n=1"

Before fix: 502 error with "Image edit returned no results"
After fix: Returns properly edited image

Additional Notes

• The /v1/images/generations endpoint works correctly because it uses a different code path
• The image upload succeeds, so the issue is specifically with the chat service model configuration
• This aligns with Grok's actual API which uses "modelName":"imagine-image-edit" for image editing operations