使用 JSON 编辑图像

POST/v1/images/edits

使用 JSON 请求体编辑图像。

请求体

application/json

prompt:必填string

描述期望输出内容的文本提示词。

示例图片改为吉卜力风格

model:必填string

本次请求使用的模型标识符。

示例gpt-image-2-ad

n:可选string

需要生成的结果数量。

size:可选string

请求生成的图像尺寸。

可选值1024x10241536x10241024x15362048x20482048x11523840x21602160x3840auto

示例auto

type:可选string

接口需要返回的结果形式。

可选值url

示例url

reference_images:必填array

提供给模型的参考图像。

示例["https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcTadhETeWmB0HglBew1luqsPidqb-KtfA17dab-V9r1b3KOThS7JZlNwKw&s=10"]

响应

200

成功时返回 JSON 响应。完整示例显示在右侧代码面板中。

兼容格式参考

以下外部文档可用于了解兼容供应商格式中的扩展参数。

https://docs.newapi.ai/en/docs/api

1curl --request POST \2 --url 'https://api.unifyllm.top/v1/images/edits' \3 --header 'Authorization: Bearer <YOUR_API_KEY>' \4 --header 'Content-Type: application/json' \5 --data '{6 "model": "gpt-image-2-ad",7 "prompt": "图片改为吉卜力风格",8 "size": "3840x2160",9 "type": "url",10 "reference_images": [11 "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcTadhETeWmB0HglBew1luqsPidqb-KtfA17dab-V9r1b3KOThS7JZlNwKw&s=10"12 ]13}'

1{2 "model": "gpt-image-2-ad",3 "prompt": "图片改为吉卜力风格",4 "size": "3840x2160",5 "type": "url",6 "reference_images": [7 "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcTadhETeWmB0HglBew1luqsPidqb-KtfA17dab-V9r1b3KOThS7JZlNwKw&s=10"8 ]9}

1{2 "id": "resp_08eee34deb147259016a55e17d834c819a9aff22e251c367b0",3 "object": "response",4 "created_at": 1784013181,5 "status": "completed",6 "background": false,7 "completed_at": 1784013184,8 "error": null,9 "frequency_penalty": 0,10 "incomplete_details": null,11 "instructions": "You are a helpful assistant.",12 "max_output_tokens": null,13 "max_tool_calls": null,14 "model": "gpt-5.5",15 "moderation": null,16 "output": [17 {18 "id": "msg_08eee34deb147259016a55e17e12a8819a8efec3711f7575f4",19 "type": "message",20 "status": "completed",21 "content": [22 {23 "type": "output_text",24 "annotations": [],25 "logprobs": [],26 "text": "A gentle unicorn named Luma lived in a moonlit meadow where the flowers glowed softly at night. \nEach evening, she sprinkled stardust from her silver horn to help lost fireflies find their way home. \nWhen the sky filled with twinkling lights, Luma curled beneath a velvet tree and dreamed of rainbow clouds."27 }28 ],29 "phase": "final_answer",30 "role": "assistant"31 }32 ],33 "parallel_tool_calls": true,34 "presence_penalty": 0,35 "previous_response_id": null,36 "prompt_cache_key": "034b1177-b68a-4e30-b3cc-0d4e7f3eec74",37 "prompt_cache_retention": "24h",38 "reasoning": {39 "context": "current_turn",40 "effort": "medium",41 "mode": "standard",42 "summary": null43 },44 "safety_identifier": "user-9f6nlV797bodUQhVEfE26DER",45 "service_tier": "default",46 "store": false,47 "temperature": 1,48 "text": {49 "format": {50 "type": "text"51 },52 "verbosity": "medium"53 },54 "tool_choice": "auto",55 "tool_usage": {56 "image_gen": {57 "input_tokens": 0,58 "input_tokens_details": {59 "image_tokens": 0,60 "text_tokens": 061 },62 "output_tokens": 0,63 "output_tokens_details": {64 "image_tokens": 0,65 "text_tokens": 066 },67 "total_tokens": 068 },69 "web_search": {70 "num_requests": 071 }72 },73 "tools": [],74 "top_logprobs": 0,75 "top_p": 0.98,76 "truncation": "disabled",77 "usage": {78 "input_tokens": 27,79 "input_tokens_details": {80 "cache_write_tokens": 0,81 "cached_tokens": 082 },83 "output_tokens": 72,84 "output_tokens_details": {85 "reasoning_tokens": 086 },87 "total_tokens": 9988 },89 "user": null,90 "metadata": {}91}