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 <token>形式のBearer認証。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