- 前言(必读)
- OpenAI官方SDK使用教程
- 批量请求示例
- 聊天模型(Chat)
- 内容审查
- 向量嵌入
- 图片处理
- 音频模型(Audio)
- 绘画模型(Painting)
- 视频模型(Video)
- 音乐创作(suno)
- 文档处理
- 3D模型
- 更多接口开发中...
- 查询令牌用量GET
- 查询令牌限额GET
查询:任务结果
GET
/visual/{action}/{task_id}
sync
参数为0时才需要使用该接口查询查询任务 | 查询接口 |
---|---|
智能抠图 | /visual/segmentation/:task_id |
图片清晰化 | /visual/scale/:task_id |
图片去水印 | /visual/inpaint/:task_id |
图片加背景 | /visual/r-background/:task_id |
请求参数
Authorization
在 Header 添加参数
Authorization
,其值为在 Bearer 之后拼接 Token示例:
Authorization: Bearer ********************
Path 参数
action
enum<string>
任务事件
枚举值:
segmentationscaler-backgroundidphoto
示例值:
segmentation
task_id
string
任务ID
示例值:
28e9810b-ca6a-4c0d-8af2-13aa1a48949c
示例代码
Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request GET 'https://api.gpt.ge/visual/segmentation/28e9810b-ca6a-4c0d-8af2-13aa1a48949c'
返回响应
🟢200成功
application/json
Body
data
object
必需
mask
string
必需
image
string
必需
state
integer
任务状态
任务状态码 | 说明 |
---|---|
-8 | 处理超时,最长处理时间30秒 |
-7 | 无效图片文件(比如图片损坏、格式不对等) |
-5 | 图片超出大小(15MB) |
-3 | 服务器下载图片文件失败,请检查图片URL是否可用 |
-2 | 任务处理完成,但任务结果上传OSS失败 |
-1 | 任务处理失败 |
0 | 任务正在队列中 |
1 | 任务处理完成 |
2 | 准备中 |
3 | 等待中 |
4 | 处理中 |
task_id
string
必需
progress
integer
必需
created_at
integer
必需
completed_at
integer
必需
processed_at
integer
必需
status
integer
必需
响应状态码 | 说明 |
---|---|
200 | 请求成功 |
400 | 客户端参数传递错误。请检查参数是否缺失或值是否正确 |
404 | 请求的URL或资源不存在。请检查URL 或 URL中的 task id 是否正确 |
413 | 上传的文件超出大小限制。请检查文件大小,参见各个服务的最大文件限制 |
429 | 请求频率超出QPS限制(默认QPS为2)。请放缓请求速率,或者联系商家提高QPS限制 |
500 | 服务端异常。请反馈给商家或技术对接人员 |
示例
{
"data": {
"mask": "",
"image": "https://wxtechsz.oss-cn-shenzhen.aliyuncs.com/tasks/output/segmentation/28e9810b-ca6a-4c0d-8af2-13aa1a48949c-image.png?x-oss-credential=LTAI5tGjJnh66c1txANiRBQN/20250322/cn-shenzhen/oss/aliyun_v4_request&x-oss-date=20250322T184329Z&x-oss-expires=3600&x-oss-signature=d5c637a8e7bb4535fb5924e3d1b96d49dd475c43e194d3dc8b3beb4826faa2b2&x-oss-signature-version=OSS4-HMAC-SHA256",
"state": 1,
"task_id": "28e9810b-ca6a-4c0d-8af2-13aa1a48949c",
"progress": 100,
"created_at": 1742668552,
"completed_at": 1742668553,
"processed_at": 1742668552
},
"status": 200
}
修改于 2025-03-22 19:19:01