运营
发布/订单
总结 | 提交新订单 | ||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
URL | / api / v1 /订单 | ||||||||||
详细说明 | 提交一份新的订单以便抄写。订单请求包含两个主要元素:
付款将从用户的账户余额中扣除。 |
||||||||||
请求头 |
|
||||||||||
请求体 | 包含订单详细信息的XML或JSON。请参阅下面的示例实体,以说明所使用的字段。 | ||||||||||
响应 | 成功,201创建。 错误,400坏请求。 |
||||||||||
响应头 |
|
||||||||||
响应体 | 成功,空。出错,将包含一个<错误/>实体,具有更多详细信息。 | ||||||||||
错误代码 |
|
||||||||||
注释样本请求 |
{/ *可选,对于客户端* /“client_ref”的订单的参考编号:“xb432423”,/ *强制性,提供有关需要转录的信息,并允许设置任何转录选项。* /“transcription_options”:{/ *强制性,包含要传授的媒体列表。必须具有至少一个元素* /“输入”:[{/ *音频长度,以秒为单位。* /“Audio_Length_seconds”:60,/ *媒体URI,从呼叫到发布/输入* /,“URI”:“URN:Rev:InputMedia:467432FDS”,/ *可选,扬声器名称列表。兼容任何输入格式。* /“扬声器”:[“John”,“Jane”,“Sam Jones”],/ *可选,词汇表项列表。兼容任何输入格式。* /“词汇表”:[“加密”,“MD5”,“SHA-1”,“BCRYPT”,/ *可选,扬声器口音清单。兼容任何输入格式。* /“口音”:[“英国”,“AmericAnnutral”,“其他”]},{/ * YouTube URL,自动确定音频长度。 */ "external_link": "http://www.youtube.com/watch?v=UF8uR6Z6KLc" }, { /* For any other external link URL audio length is mandatory */ "audio_length_seconds": 300, "external_link": "https://vimeo.com/7976699" } ], /* Optional, should we transcribe the provided files verbatim? If true, all filler words (i.e. umm, huh) will be included. Requesting Verbatim adds $0.25 / minute to the cost of your orders. */ "verbatim": true, /* Optional, should we include timestamps? Timestamps are available in the JSON format, and are free. We make a best effort for the timestamps to be per-word, but do not guarantee it. */ "timestamps": true, /* Optional, should we rush this order? Rush will deliver your files up to 5x faster. Requesting Rush adds $1 per audio minute to the cost of your orders. We expect a high degree of accuracy with these files. However, speaker names may be inconsistent for files over 30 minutes. */ "rush": true, /* Optional, should we create an instant machine-generated first draft? Requesting an Instant First Draft adds $0.10 per audio minute to the cost of your orders. */ "instant_first_draft": true /* Optional, what file formats should the transcripts be optimized for. See table in description section for supported formats. By default, we optimize for Microsoft Word. */ "output_file_formats": ["MS Word", "JSON"] }, /* Optional, enables receiving notifications about the order status */ "notification": { /* The url for notifications. Mandatory if the notifications element is used. Updates will be posted to this URL */ "url": "http://www.clientsite.com/orderupdate", /* Optional, specifies which notifications are sent. If "Detailed", then a notification is sent whenever the order is in a new status or has a new comment. If "FinalOnly" (the default), notification is sent only when the order is complete. */ "level": "Detailed" }, /* Optional- customer must have invoicing, it links order to PO, Project, or Department for billing */ "ponumber": "SamplePoNumber01" } < order_request > < !——可选,对客户端有意义的订单引用号——> |