Documentation Index
Fetch the complete documentation index at: /llms.txt
Use this file to discover all available pages before exploring further.
비동기 작업을 위한 Webhook 콜백 프로토콜
업데이트: 2026-06-06
notifyHook 파라미터로 콜백 주소를 지정합니다.
{
"prompt": "a beautiful sunset",
"notifyHook": "https://your-server.com/api/callback"
}
POST https://your-server.com/api/callback
Content-Type: application/json
{
"id": "task_abc123",
"action": "IMAGINE",
"status": "SUCCESS",
"prompt": "a beautiful sunset",
"imageUrl": "https://cdn.example.com/image.png",
"progress": "100%",
"failReason": "",
"submitTime": 1706000000000,
"startTime": 1706000010000,
"finishTime": 1706000060000
}
{
"id": "task_xyz789",
"status": "succeed",
"type": "video",
"output": {
"video_url": "https://cdn.example.com/video.mp4",
"cover_url": "https://cdn.example.com/cover.jpg",
"duration": 5.0
},
"created_at": 1706000000,
"updated_at": 1706000120
}
{
"id": "task_music456",
"status": "complete",
"output": {
"audio_url": "https://cdn.example.com/song.mp3",
"title": "My Song",
"duration": 180
}
}
제출 → NOT_START → IN_PROGRESS → SUCCESS / FAILURE
from flask import Flask, request, jsonify
app = Flask(__name__)
@app.route("/api/callback", methods=["POST"])
def callback():
data = request.json
task_id = data["id"]
status = data["status"]
print(f"작업 {task_id} 상태 업데이트: {status}")
if status == "SUCCESS":
image_url = data.get("imageUrl")
print(f"이미지 주소: {image_url}")
return jsonify({"success": True})
app.run(port=8080)
const express = require('express');
const app = express();
app.use(express.json());
app.post('/api/callback', (req, res) => {
const { id, status, imageUrl } = req.body;
console.log(`작업 ${id} 상태: ${status}`);
if (status === 'SUCCESS') {
console.log(`이미지: ${imageUrl}`);
}
res.json({ success: true });
});
app.listen(8080);