# 异步任务与账户

多引擎、多采样的请求可能要等一两分钟，建议传 async: true：接口立即返回 job_id，结果用轮询或 webhook 取回。同步请求超过 120 秒会自动转为异步，并返回 202。

### 接口

| 接口 | 说明 | credits |
| --- | --- | --- |
| `GET /v1/jobs/{job_id}` | 查询任务状态和结果 | 0 |
| `GET /v1/account` | 查询余额、档位、本月用量 | 0 |

### 异步请求的响应

```json
{
  "job_id": "job_3b7e90",
  "status": "queued",
  "credits_held": 9
}
```

`GET /v1/account`

```json
{
  "plan": "scale",
  "credits_remaining": 10422,
  "credits_used_this_month": 1578
}
```

- status 依次为 queued、running、completed 或 failed；completed 时 result 字段与同步响应相同。
- 异步请求里 timeout 或 failed 的答案会在约 2 分钟后自动补跑一轮，仍失败才定为最终结果；同步请求不补跑。
- credits_held 是预占的 credits，完成后按实际返回的答案结算，多余部分退回。
- 传了 webhook_url 时，完成后向该地址 POST 完整结果，请求头带 x-dataforgeo-signature（HMAC-SHA256，密钥在控制台查看），用于验证来源。
- 任务结果保留 7 天。