resources/content_provenance_checks/methods/create/index.md

Create content provenance check

post /content_provenance_checks

Check whether an image or audio file contains known OpenAI provenance signals. Learn more about content provenance.

If not_detected, it means the tool did not find supported signals in the uploaded file. The content could still have been generated by OpenAI if the metadata was stripped or has evidence of tampering, the watermark was degraded, it comes from a legacy generation model, or it was created before provenance signals were available. Content could also still be AI-generated by another company's model, which the tool currently does not detect.

Returns

ContentProvenanceCheck object { created_at, object, results }
- created_at: number
  
  The Unix timestamp, in seconds, when the provenance check was created.
- object: "content_provenance_check"
  
  The object type. Always content_provenance_check for this endpoint.
  - "content_provenance_check"
- results: array of object { generated_at, issuer, model, 3 more } or object { generated_at, model, outcome, type }
  
  The provenance results that apply to the uploaded file. Image results include C2PA and SynthID; audio results include SynthID.
  - C2PA object { generated_at, issuer, model, 3 more }
    - generated_at: string or null
      
      The UTC RFC 3339 timestamp recorded by the provenance signal for when the asset was generated, when available.
    - issuer: string or null
      
      The C2PA manifest issuer, when available.
    - model: string or null
      
      The OpenAI model recorded by the provenance signal, when available.
    - outcome: "detected" or "not_detected"
      
      Whether a supported OpenAI C2PA provenance signal was detected. If not_detected, it means the tool did not find supported signals in the uploaded file. The content could still have been generated by OpenAI if the metadata was stripped or has evidence of tampering, the watermark was degraded, it comes from a legacy generation model, or it was created before provenance signals were available. Content could also still be AI-generated by another company's model, which the tool currently does not detect.
      - "detected"
      - "not_detected"
    - type: "c2pa"
      
      The provenance signal type. Always c2pa.
      - "c2pa"
    - validation_state: "trusted" or "valid" or "invalid" or "not_present"
      
      The validation status of the C2PA manifest in the uploaded image.
      - "trusted"
      - "valid"
      - "invalid"
      - "not_present"
  - SynthID object { generated_at, model, outcome, type }
    - generated_at: string or null
      
      The UTC RFC 3339 timestamp recorded by the provenance signal for when the asset was generated, when available.
    - model: string or null
      
      The OpenAI model recorded by the provenance signal, when available.
    - outcome: "detected" or "not_detected"
      
      Whether a supported OpenAI SynthID watermark was detected. If not_detected, it means the tool did not find supported signals in the uploaded file. The content could still have been generated by OpenAI if the metadata was stripped or has evidence of tampering, the watermark was degraded, it comes from a legacy generation model, or it was created before provenance signals were available. Content could also still be AI-generated by another company's model, which the tool currently does not detect.
      - "detected"
      - "not_detected"
    - type: "synthid"
      
      The provenance signal type. Always synthid.
      - "synthid"

Example

curl https://api.openai.com/v1/content_provenance_checks \
    -H 'Content-Type: multipart/form-data' \
    -H "Authorization: Bearer $OPENAI_API_KEY" \
    -F 'file=@/path/to/file'

Response

{
  "created_at": 0,
  "object": "content_provenance_check",
  "results": [
    {
      "generated_at": "generated_at",
      "issuer": "issuer",
      "model": "model",
      "outcome": "detected",
      "type": "c2pa",
      "validation_state": "trusted"
    }
  ]
}

resources/content_provenance_checks/methods/create/index.md +119 −0 created

1## Create content provenance check

3**post** `/content_provenance_checks`

5Check whether an image or audio file contains known OpenAI provenance signals. [Learn more about content provenance](/api/docs/guides/content-provenance).

7If `not_detected`, it means the tool did not find supported signals in the uploaded file. The content could still have been generated by OpenAI if the metadata was stripped or has evidence of tampering, the watermark was degraded, it comes from a legacy generation model, or it was created before provenance signals were available. Content could also still be AI-generated by another company's model, which the tool currently does not detect.

9### Returns

11- `ContentProvenanceCheck object { created_at, object, results }`

13 - `created_at: number`

15 The Unix timestamp, in seconds, when the provenance check was created.

17 - `object: "content_provenance_check"`

19 The object type. Always `content_provenance_check` for this endpoint.

21 - `"content_provenance_check"`

23 - `results: array of object { generated_at, issuer, model, 3 more } or object { generated_at, model, outcome, type }`

25 The provenance results that apply to the uploaded file. Image results include C2PA and SynthID; audio results include SynthID.

27 - `C2PA object { generated_at, issuer, model, 3 more }`

29 - `generated_at: string or null`

31 The UTC RFC 3339 timestamp recorded by the provenance signal for when the asset was generated, when available.

33 - `issuer: string or null`

35 The C2PA manifest issuer, when available.

37 - `model: string or null`

39 The OpenAI model recorded by the provenance signal, when available.

41 - `outcome: "detected" or "not_detected"`

43 Whether a supported OpenAI C2PA provenance signal was detected.

44 If `not_detected`, it means the tool did not find supported signals in the uploaded file. The content could still have been generated by OpenAI if the metadata was stripped or has evidence of tampering, the watermark was degraded, it comes from a legacy generation model, or it was created before provenance signals were available. Content could also still be AI-generated by another company's model, which the tool currently does not detect.

46 - `"detected"`

48 - `"not_detected"`

50 - `type: "c2pa"`

52 The provenance signal type. Always `c2pa`.

54 - `"c2pa"`

56 - `validation_state: "trusted" or "valid" or "invalid" or "not_present"`

58 The validation status of the C2PA manifest in the uploaded image.

60 - `"trusted"`

62 - `"valid"`

64 - `"invalid"`

66 - `"not_present"`

68 - `SynthID object { generated_at, model, outcome, type }`

70 - `generated_at: string or null`

72 The UTC RFC 3339 timestamp recorded by the provenance signal for when the asset was generated, when available.

74 - `model: string or null`

76 The OpenAI model recorded by the provenance signal, when available.

78 - `outcome: "detected" or "not_detected"`

80 Whether a supported OpenAI SynthID watermark was detected.

81 If `not_detected`, it means the tool did not find supported signals in the uploaded file. The content could still have been generated by OpenAI if the metadata was stripped or has evidence of tampering, the watermark was degraded, it comes from a legacy generation model, or it was created before provenance signals were available. Content could also still be AI-generated by another company's model, which the tool currently does not detect.

83 - `"detected"`

85 - `"not_detected"`

87 - `type: "synthid"`

89 The provenance signal type. Always `synthid`.

91 - `"synthid"`

93### Example

95```http

96curl https://api.openai.com/v1/content_provenance_checks \

97 -H 'Content-Type: multipart/form-data' \

98 -H "Authorization: Bearer $OPENAI_API_KEY" \

99 -F 'file=@/path/to/file'

100```

101

102#### Response

103

104```json

105{

106 "created_at": 0,

107 "object": "content_provenance_check",

108 "results": [

109 {

110 "generated_at": "generated_at",

111 "issuer": "issuer",

112 "model": "model",

113 "outcome": "detected",

114 "type": "c2pa",

115 "validation_state": "trusted"

116 }

117 ]

118}

119```