{
  "code": 200,
  "msg": "success",
  "data": 100
}

​
欢迎使用 Veo3 API

本指南将引导您完成第一次API调用，包括生成视频、上传文件和检查账户状态。您将在几分钟内完成设置！
前提条件：您需要从 veo3api.ai/api-key 获取API密钥才能开始。

​
步骤1：身份验证设置

所有API请求都需要Bearer令牌身份验证。以下是设置方法： 
const apiKey = 'YOUR_API_KEY';
const headers = {
  'Authorization': `Bearer ${apiKey}`,
  'Content-Type': 'application/json'
};
将 YOUR_API_KEY 替换为您的实际API密钥。永远不要在客户端代码或公共仓库中暴露您的API密钥。

​
步骤2：检查您的积分

在生成视频之前，让我们检查一下您的可用积分： 
const response = await fetch('https://api.veo3api.ai/api/v1/common/credit', {
  method: 'GET',
  headers: {
    'Authorization': `Bearer ${apiKey}`
  }
});

const data = await response.json();
console.log(`剩余积分: ${data.data}`);

{
  "code": 200,
  "msg": "success",
  "data": 100
}

​
步骤3：生成您的第一个视频

现在让我们从文本提示创建一个视频：

​
文本转视频生成

const generateVideo = async () => {
  const response = await fetch('https://api.veo3api.ai/api/v1/veo/generate', {
    method: 'POST',
    headers: headers,
    body: JSON.stringify({
      prompt: "一只金毛猎犬在阳光明媚的公园里玩接球游戏，慢动作，电影级照明",
      model: "veo3",
      aspectRatio: "16:9",
      watermark: "MyBrand"
    })
  });
  
  const result = await response.json();
  return result.data.taskId;
};

const taskId = await generateVideo();
console.log(`视频生成已开始。任务ID: ${taskId}`);

{
  "code": 200,
  "msg": "success",
  "data": {
    "taskId": "veo_task_abcdef123456"
  }
}

​
图片转视频生成

您也可以让现有图片动起来。首先，上传一张图片： 
// 首先上传图片
const formData = new FormData();
formData.append('file', imageFile);
formData.append('uploadPath', 'images/user-uploads');

const uploadResponse = await fetch('https://veo3apiai.redpandaai.co/api/file-stream-upload', {
  method: 'POST',
  headers: {
    'Authorization': `Bearer ${apiKey}`
  },
  body: formData
});

const uploadResult = await uploadResponse.json();
const imageUrl = uploadResult.data.downloadUrl;

// 然后从图片生成视频
const videoResponse = await fetch('https://api.veo3api.ai/api/v1/veo/generate', {
  method: 'POST',
  headers: headers,
  body: JSON.stringify({
    prompt: "图片中的人物开始自信地向前走",
    imageUrls: [imageUrl],
    model: "veo3",
    aspectRatio: "16:9"
  })
});

​
步骤4：检查视频状态

视频生成需要时间。使用任务ID检查进度： 
const checkVideoStatus = async (taskId) => {
  const response = await fetch(
    `https://api.veo3api.ai/api/v1/veo/record-info?taskId=${taskId}`,
    {
      method: 'GET',
      headers: {
        'Authorization': `Bearer ${apiKey}`
      }
    }
  );
  
  const result = await response.json();
  return result.data;
};

// 定期检查状态
const checkStatus = async () => {
  const status = await checkVideoStatus(taskId);
  
  if (status.successFlag === 1) {
    console.log('视频生成成功！');
    console.log('视频URL:', status.response.resultUrls);
  } else if (status.successFlag === 0) {
    console.log('仍在生成中...');
    setTimeout(checkStatus, 30000); // 30秒后再次检查
  } else {
    console.log('生成失败:', status.errorMessage);
  }
};

checkStatus();

{
  "code": 200,
  "msg": "success",
  "data": {
    "taskId": "veo_task_abcdef123456",
    "successFlag": 1,
    "response": {
      "resultUrls": [
        "https://example.com/generated-video.mp4"
      ]
    },
    "completeTime": "2024-03-20T10:30:00Z"
  }
}

​
步骤5：获取1080P版本（可选）

对于16:9纵横比的视频，您可以获取高清1080P版本： 
const get1080pVideo = async (taskId) => {
  const response = await fetch(
    `https://api.veo3api.ai/api/v1/veo/get-1080p-video?taskId=${taskId}&index=0`,
    {
      method: 'GET',
      headers: {
        'Authorization': `Bearer ${apiKey}`
      }
    }
  );
  
  const result = await response.json();
  return result.data.resultUrl;
};

const hdVideoUrl = await get1080pVideo(taskId);
console.log('1080P视频URL:', hdVideoUrl);

​
文件上传方式

平台支持三种不同的文件上传方式：
非常适合从您的应用程序直接上传文件：
const formData = new FormData();
formData.append('file', fileInput.files[0]);
formData.append('uploadPath', 'images/user-uploads');
formData.append('fileName', 'my-image.jpg');

const response = await fetch('https://veo3apiai.redpandaai.co/api/file-stream-upload', {
  method: 'POST',
  headers: {
    'Authorization': `Bearer ${apiKey}`
  },
  body: formData
});

​
最佳实践

​
下一步

Veo3 视频 API

探索视频生成API文档

文件上传 API

掌握所有文件上传方式和选项

账户管理

监控您的API使用情况和积分余额
恭喜！您已经成功完成了第一次API调用。继续探索我们的文档以释放Veo3 API平台的全部潜力。