从 C2C 设备创建评论 | Frame.io API Documentation

import requests
url = "https://api.frame.io/v2/devices/assets/asset_id/comments"
payload = { "text": "string" }
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.json())

{
  "annotation": "string",
  "completed": false,
  "completed_at": "string",
  "completer_id": "string",
  "has_replies": false,
  "id": "eeeeeeee-eeee-eeee-eeee-eeeeeeeeeeee",
  "like_count": 0,
  "owner": {
    "digest_frequency": "0 * * * *",
    "features_seen": "string",
    "profile_image_original": "string",
    "image_32": "string",
    "image_128": "string",
    "from_google": false,
    "mfa_enforced_at": "string",
    "email": "jane@frame.io",
    "bio": "string",
    "name": "Jane Doe",
    "image_64": "string",
    "timezone_value": "America/New_York",
    "account_id": "string",
    "updated_at": "2025-12-19T14:55:05.324848Z",
    "image_256": "string",
    "_type": "user",
    "context": {
      "company_name": "string",
      "id": "aaaaaaaa-aaaa-aaaa-aaaa-aaaaaaaaaaaa",
      "industry": "string",
      "job_title": "string",
      "role": "string",
      "team_size": 2
    },
    "upload_url": "string",
    "location": "string",
    "phone": "string",
    "deleted_at": "string",
    "profile_image": "https://static-assets.frame.io/app/anon.jpg",
    "first_login_at": "2025-09-17T18:09:39.768640Z",
    "joined_via": "organic",
    "email_confirm_by": "string",
    "id": "cccccccc-cccc-cccc-cccc-cccccccccccc",
    "next_digest_date": "2025-09-17T18:09:35.668306Z",
    "email_preferences": "string",
    "last_seen": "string",
    "inserted_at": "2025-09-17T18:09:35.685694Z",
    "from_adobe": true,
    "avatar_color": "yellow",
    "highest_account_role": "string",
    "integrations": [
      "string"
    ],
    "roles": {
      "admin": false,
      "id": "bbbbbbbb-bbbb-bbbb-bbbb-bbbbbbbbbbbb",
      "sales": true,
      "support": true,
      "service_desk": false
    },
    "user_default_color": "#ff409f"
  },
  "owner_id": "cccccccc-cccc-cccc-cccc-cccccccccccc",
  "text": "This is a comment from the camera",
  "timestamp": 33,
  "_type": "comment",
  "anonymous_user_id": "string",
  "aspect_ratio": 1.777778,
  "asset_id": "dddddddd-dddd-dddd-dddd-dddddddddddd",
  "comment_entities": [],
  "deleted_at": "string",
  "device_channel_input_id": "string",
  "duration": 1,
  "fov": 65,
  "frame": 33,
  "inserted_at": "2026-01-28T19:31:40.501158Z",
  "page": 1,
  "parent_id": "string",
  "pitch": 1,
  "private": true,
  "read_count": 0,
  "review_link_id": "string",
  "target_asset_id": "string",
  "text_edited_at": "string",
  "thumb": "string",
  "timestamp_microseconds": 1,
  "updated_at": "2026-01-28T19:31:40.523368Z",
  "yaw": 1
}

通过已配对的 C2C 设备对资产发表评论。

身份验证

AuthorizationBearer

Bearer 身份验证，格式为 Bearer <token>，其中 token 是您的身份验证令牌。

路径参数

asset_idstring必需格式: "uuid"

Asset ID

请求

Comment to create or update

textstring必需

The body of the comment.

timestampdouble可选

Timestamp for the comment, in frames, starting at 0. Comments can be "global" to an asset in which you don't provide the timestamp.

响应

C2C Comment success response

annotationstring可选

completedboolean可选

completed_atstring可选

completer_idstring可选格式: "uuid"

has_repliesboolean可选

idstring可选格式: "uuid"

like_countinteger可选

ownerobject可选

用户模型

owner_idstring可选格式: "uuid"

textstring可选

timestampinteger可选

_typestring可选

anonymous_user_idstring可选格式: "uuid"

aspect_ratiodouble可选

asset_idstring可选格式: "uuid"

comment_entitieslist of any可选

deleted_atstring可选

device_channel_input_idstring可选

durationinteger可选

fovinteger可选

framedouble可选

inserted_atstring可选

pageinteger可选

parent_idstring可选格式: "uuid"

pitchinteger可选

privateboolean可选

read_countinteger可选

review_link_idstring可选格式: "uuid"

target_asset_idstring可选格式: "uuid"

text_edited_atstring可选

thumbstring可选

timestamp_microsecondsinteger可选

updated_atstring可选

yawinteger可选

错误

400

Bad Request Error

401

Unauthorized Error

404

Not Found Error

429

Too Many Requests Error